Why do I get a 429 Too Many Requests error when using the API?

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

The Cloudcraft API returns an HTTP 429 Too Many Requests response when you trigger the rate limit in place for the endpoint you called.

Current limits:

  • 20 requests per minute for https://api.cloudcraft.co/.
  • 5 requests per minute for https://api.cloudcraft.co/blueprint/BLUEPRINT_ID/FORMAT.

The Cloudcraft platform relies on these limits to maintain service quality for all users, and increasing them is not possible at the moment.

Avoiding the limit

You can take the following precautions to avoid triggering the rate limit:

  1. Ensure the resources accessed are unique. If the same account or blueprint is accessed repeatedly, only access it once within the rate limiting period and cache the result locally.
  2. Implement rate limit detection with exponential backoff. The request is never processed when hitting the limit, so try to detect the HTTP 429 Too Many Requests response from the API and wait 60 seconds before continuing.