Common error codes
API calls may return an error. You can use this document to find the cause of an error based on the returned error code and resolve the issue.
1. Throttling.User: API call limit exceeded
Error message: Flow control was triggered.
Solution: This error indicates that the service request frequency is too high and exceeds the Queries Per Second (QPS) limit. The default concurrent QPS limit is 10 for both resource plans and pay-as-you-go services. To resolve this issue, reduce the service request frequency. You can use a queue to process API calls in batches with a delay. You can also purchase a monthly subscription to increase the QPS limit. The QPS is calculated based on the total number of calls to all APIs.
Use the following links to purchase a monthly subscription:
Premium Edition Monthly Service
2. InternalError: Internal service error
Error message: A service error occurred.
Solution: This error usually indicates that the request parameters are invalid. For example, the `sim_level` API, which compares address similarity, requires an input parameter of two addresses separated by a semicolon (;).
3. UserStatusInvalid: Invalid user status
Error message: The user status is invalid.
Solution: Grant the required permissions to the Resource Access Management (RAM) user. For more information, see RAM Authentication. Also, check that your `accessKeyId`, `accessKeySecret`, `appKey`, and other parameters are correct. For more information, see Signature Mechanism.
4. Forbidden.NoAuth: User authentication failed
Error message: User authentication failed.
Solution: Grant the required permissions to the RAM user. For more information, see RAM Authentication. Also, check that your `accessKeyId`, `accessKeySecret`, `appKey`, and other parameters are correct. For more information, see Signature Mechanism.