Usage Limits
API usage limits are implemented as a set of conditions to control the overall load on the resources required to deliver requests, so no one caller overwhelms the API causing performance degradation for everyone.
The standard limit is as follows. This applies individually to each user or M2M account:
-
Quota: 35,000 Requests per day
-
Rate: 20 Requests per second
If these limits are reached, the request will fail with status code 429 until the end of the current period. Daily usage is reset at UTC midnight (10am AEST).
Usage Endpoint
https://api.afl.championdata.io/v1/usage
The usage endpoint returns your account's API usage for the past seven days, showing your daily limit and how many calls were made in that 24-hour period. This endpoint updates at the same time as the usage limit.
Usage limits are per environment. So calls to sandbox don't affect your usage limit on production.
M2M Access Tokens
M2M access tokens have a 24-hour lifetime and must be cached for repeated use throughout the day. We recommend you only retrieve a new token once the existing token has expired.
We provide each M2M account 10 access tokens every day, allowing a single M2M to be used in up to 10 places per day without exhausting the supply of tokens. Once the supply is exhausted, the M2M will not be able to authenticate with the AFL API for the rest of the day.
For more information, please review the Auth0 article on token storage here.
If a M2M is reused in multiple places, note that it only has a single API usage limit, so the more heavily used the M2M, the more likely the API usage limit will be reached.