Troubleshooting Common Issues with the Telecom Score API

Introduction
When integrating the Telecom Score API, various issues may arise related to invalid parameters, unsupported phone numbers, or service errors. This guide highlights common issues and provides troubleshooting steps to resolve them.

1. Invalid Phone Number Format

Error Message: INVALID_PHONE_NUMBER
Cause: The phone number provided is in an incorrect format.
Solution: Ensure the phone number is correctly formatted with the appropriate country and area codes. For mobile numbers, leave the areaCode field as an empty string "".

2. Unsupported Phone Operator

Error Message: UNSUPPORTED_PHONE_OPERATOR
Cause: The phone number’s operator is not supported by the Telecom Score API.
Solution: Verify that the phone number belongs to a supported operator. Currently, only numbers with specific prefixes (e.g., 811, 812, 813) are supported.

3. Phone Number Not Found

Error Message: PHONE_NUMBER_NOT_FOUND
Cause: The API cannot find sufficient data on the phone number to generate a score.
Solution: Double-check the phone number’s accuracy and ensure the user’s telecom provider is supported by the API.

4. Country Code Not Supported

Error Message: COUNTRY_CODE_NOT_SUPPORTED
Cause: The country code provided in the request is not supported by the API.
Solution: Check the list of supported country codes and use a valid one, such as +62 for Indonesia or +65 for Singapore.

5. Parameter Errors

Error Message: PARAMETER_ERROR
Cause: Required parameters are missing or incorrectly formatted.
Solution: Ensure that all required fields (countryCode, areaCode, number) are provided and formatted correctly.

6. Client Error

Error Message: CLIENT_ERROR
Cause: The server has returned an HTTP client error (e.g., 400 - Bad Request).
Solution: Check the API documentation to ensure that the request structure and parameters are correct. If the issue persists, review the raw request and response logs for clues.

7. Account Disabled

Error Message: ACCOUNT_DISABLED
Cause: Your account has been disabled or deactivated.
Solution: Contact your account manager or support to resolve account-related issues.

Conclusion
By addressing these common issues and following the recommended troubleshooting steps, you can resolve most problems encountered when using the Telecom Score API.

Further Assistance

If you continue to experience issues despite following the guidelines provided, please contact our support team for further assistance: