Labels Cheap API v2

1. Check Response Status

Always check the STATUS field in the response. If it's "error", handle the error appropriately.

2. Handle Different Error Categories

• Authentication Errors (1000-1999): Prompt user to check API key or re-authenticate
• Validation Errors (2000-2999): Display validation messages to the user
• Business Logic Errors (3000-3999): Handle business-specific scenarios (insufficient balance, limits, etc.)
• System Errors (4000-4999): Implement retry logic with exponential backoff
• External API Errors (5000-5999): Implement fallback mechanisms or retry later

3. Implement Retry Logic

For transient errors (5xx status codes), implement retry logic with exponential backoff:

function retryWithBackoff(fn, maxRetries = 3) {
    return async (...args) => {
        for (let i = 0; i < maxRetries; i++) {
            try {
                return await fn(...args);
            } catch (error) {
                if (i === maxRetries - 1) throw error;
                if (error.code >= 4000 && error.code < 6000) {
                    await new Promise(resolve => 
                        setTimeout(resolve, Math.pow(2, i) * 1000)
                    );
                } else {
                    throw error;
                }
            }
        }
    };
}

4. Rate Limiting

Handle rate limiting errors (429) by implementing proper throttling:

if (response.CODE === '1010') {
    // Wait before retrying
    await new Promise(resolve => setTimeout(resolve, 60000));
    // Retry the request
}

5. Logging and Monitoring

Log error codes and messages for debugging and monitoring:

if (response.STATUS === 'error') {
    console.error(`API Error ${response.CODE}: ${response.MESSAGE}`);
    // Send to monitoring service
    logError(response.CODE, response.MESSAGE, response.TIMESTAMP);
}