Official Accounts cannot call APIs without limit. To prevent unusual Weixin server load caused by Official Account program error, each Official Account is allowed to call APIs a certain number of times per day by default. When a certain limit is exceeded, the following error code will be returned if the corresponding API is called:
{"errcode":45009,"errmsg":"api freq out of limit"}
By logging in to the Weixin Official Accounts Platform, developers can view the current daily call limit and real-time call volume of each API under the account in the API Permission Template in the Developer Center at the backend. For a verified account, the real-time call volume can be cleared by following the rules below:
Due to the difference in metric calculation method or statistical time, the real-time call volume data may have errors, generally within 1%.
The calls made under each account can be cleared 10 times per month either on the platform or via an API. The clearing operation that takes effect will be counted once.
The quota of the Official Account is consumed if a call is made by a third party on its behalf.
The volume of calls to each API with a call quota can be cleared.
The call frequency limit of each API under a newly registered account is as follows:
API | Daily Quota |
---|---|
Get access_token | 2000 |
Create custom menu | 1000 |
Query custom menu | 10000 |
Delete custom menu | 1000 |
Create group | 1000 |
Get group | 1000 |
Modify group name | 1000 |
Mobile user group | 100000 |
Upload multimedia files | 100000 |
Download multimedia files | 200000 |
Send Customer Service messages | 500000 |
Advanced broadcast | 100 |
Upload articles | 10 |
Delete articles | 10 |
Get QR code with parameters | 100000 |
Get follower list | 500 |
Get user basic information | 5000000 |
Get webpage authorization access_token | None |
Refresh webpage authorization access_token | None |
Get user information for webpage authorization | None |
Set user alias | 10000 |
The call frequency limit of APIs under the test account applied for in the test account application page is as follows:
API | Daily Quota |
---|---|
Get access_token | 200 |
Create custom menu | 100 |
Query custom menu | 1000 |
Delete custom menu | 100 |
Create group | 100 |
Get group | 100 |
Modify group name | 100 |
Mobile user group | 1000 |
Media Asset Management - Upload temporary assets | 500 |
Media Asset Management - Download temporary assets | 1000 |
Send Customer Service messages | 50000 |
Get QR code with parameters | 10000 |
Get follower list | 100 |
Get user basic information | 500000 |
Get webpage authorization access_token | None |
Refresh webpage authorization access_token | None |
Get user information for webpage authorization | None |
Calling the clearing API, whether by an Official Account or a third-party platform on behalf of the Official Account, clears all the calls to the API made by the Official Account and the third-party platform:
HTTP request: POST HTTP call: https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=ACCESS_TOKEN
Calling example:
{ "appid":"APPID" }
Parameters:
Parameter | Required | Description |
---|---|---|
access_token | Yes | Credential for calling API |
appid | Yes | Official Account AppID |
For a successful request, the response is as follows:
{ "errcode" :0, "errmsg" : "ok" }
If the call frequency limit is exceeded, the following error code is returned:
{ "errcode" :48006, "errmsg" : "forbid to clear quota because of reaching the limit" }