HTTP Notes

API Rate Limiting

📌To avoid abnormal requests or attacks that may affect overall service, we have imposed restrictions on API requests.

Default total API call frequency for users is 800 times/min.

If a token exceeds the specified number of requests within 1 minute, it will be banned and automatically unbanned in the next minute.

Currently, we only provide tokens with higher request frequency permissions to clients with deep cooperation. Please contact our business team if needed.

API Updates

a. Request API to obtain initialization data
*For list-type API access, page (page number) and per_page (number of data items per page) are optional parameters. When not provided, it returns 1 page with 20 items.

b. Data updates can be obtained in 2 ways for changes

Use the recent_update field to get data changes

Access push notifications to get change data

Empty Data Format

When field types are empty:
Object: null
Array: []
String: ""
Integer: 0
Float: 0.0

API Permission Rules

Check user permissions
a. User password verification - incorrect user or password
b. User status verification - user has no permissions

Check IP whitelist - IP not authorized

Check user total request count (within time period) - total count exceeded

API count detection (time period) - API limit exceeded

Check API permissions (determine list or detail API based on rules)
a. List API
a1. Parameter sport_id (supports multiple, separated by commas) detection.
If this parameter has no value, take the sport_id from permissions as the parameter, pass and forward.
If this parameter has a value, compare with the sport_id from permissions. If it's a subset, pass; if there are non-intersecting elements, fail - no permissions
b. Detail API (path has rules containing sport_id)

b1. Take the sport_id from this path, compare with the sport_id from permissions, same method as above - no permissions
b2. Parameter ids (tentatively supports 10, separated by commas) detection, more than 10 - reject

API Rate Limiting#

API Updates#

Empty Data Format#

API Permission Rules#

API Rate Limiting

API Updates

Empty Data Format

API Permission Rules