Adjust Rate Limits
The IM Service limits the maximum API request frequency per account (App Key) to ensure that all customers can enjoy consistent, high-quality service.
- The API Interface List provides the specific rate limits for each interface. Most interfaces have a default rate limit of 100 requests per second, while some APIs are not subject to this restriction.
If the API usage exceeds these limits, the Server API will return an HTTP 429 Too Many Requests error.
Self-Service Rate Limit Adjustment
Customers with the Chat Premium Plan or Chat Ultimate Plan can self-adjust the frequency caps for certain APIs in the Production environment. Increasing the rate limit is a value-added service, and specific fees can be found in the Billing Details.
To adjust the rate limits, visit the Chat pricing plans page in the Console, switch to the Production environment of your application, and then navigate to the Extended Services tab to view all APIs that support self-service rate limit adjustments.
Notes:
- Adjusting the frequency for Broadcast to Users in the Extended Services tab will simultaneously adjust the rate limits for the following APIs:
/message/broadcast.json: Send Message-bearing Notification to All Users/push.json: Send Push-only Notification to All Users, Send Push Notification by Tag, Send Push Notification by Package Name
Known Issues
- Set Message Extension for One-to-One and Group Messages and Delete Message Extension for One-to-One and Group Messages will consume additional rate limit quotas for Send One-to-One Message (default: 6000 messages per minute) or Send Group Message (default: 20 messages per second). Since the default rate limit for the Send Group Message API is 20 messages per second, it is more susceptible to this issue. It is recommended to avoid immediately setting or deleting message extensions at a high frequency after sending group messages to prevent triggering this issue.