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

The Cloudcraft API will return 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.

Our 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 a few precautions to avoid triggering the rate limit currently in place.

  1. Ensure the resources accessed are unique. If the same account or blueprint is repeatedly accessed, 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.