Core concepts

Fair Use Policy

UAPI is committed to providing developers with a free, open, and stable API service platform. To ensure service availability and fairness for all users, we implement a fair use policy.

Dynamic Rate Limits

UAPI dynamically adjusts request limits based on overall traffic conditions. When the service is busy, the platform prioritizes keeping most normal requests available.

This is mainly intended to:

  • Maintain availability: keep the service as stable and available as possible when traffic fluctuates.
  • Ensure fairness: limit abnormally frequent or clearly unreasonable requests to avoid affecting other users.

Our Recommendations

Although rate limits are dynamic, we strongly recommend following these best practices when designing your application so it can work smoothly with UAPI:

  • Plan your request rate reasonably. Avoid sending dense concurrent requests in a short period of time, such as within a few seconds. For most applications, keeping the average request rate within 40 requests/minute is a safe and reasonable design target. This ensures your application does not create sudden pressure on our service at any time.
  • Add retry logic with exponential backoff to your API calls. When you receive a 429 Too Many Requests response, do not retry immediately; instead, wait for a gradually increasing interval.
  • Cache API responses whenever possible. For data that does not change frequently, caching is the most effective way to reduce API calls and improve your own application’s performance.

We believe a well-designed and friendly application will rarely trigger our rate limits.