English

Français

English

Français

Appearance

Rate Limiting ​

To ensure the stability, security, and performance of our infrastructure, we enforce a rate limiting policy on API calls.

🎯 Goals of rate limiting ​

Rate limiting aims to:

  • Protect against attacks that could exploit your access to our APIs
  • Prevent abuse or uncontrolled excessive calls
  • Ensure fair resource allocation among all partners
  • Protect our system against faulty code or aggressive automated behaviors
  • Maintain high service availability

⚙️ How it works ​

Each API call is counted, and a cap is applied over a sliding time window. If this cap is exceeded, extra calls will be rejected with an appropriate error code (429 Too Many Requests).

The applied limits may evolve, but as a guideline, you can expect:
Limit per API key: 1000 requests / minute

These thresholds may vary depending on the type of partnership, the environment (sandbox vs production), or specific usage validated with our team.

📦 Response when exceeding the limit ​

When a limit is reached, the API responds with:

  • HTTP Code 429: Too Many Requests
  • Cache responses whenever possible to avoid redundant calls.

This is especially relevant for endpoints related to static entities such as references, club/network_node information, etc.

  • Use webhooks to get notified of creations/changes instead of polling data frequently
  • Implement an exponential backoff strategy in case of 429 errors
  • Do not trigger uncontrolled automatic retry loops

Do you have a BI / Datalake / Big Data project? ​

APIs are not the best solution for these needs.

Resamania provides dedicated export capabilities that can fully meet such requirements. Contact us via the contact form for more information.

WARNING

Do not start a BI project using our APIs. You risk being limited (either when going live or due to our rate limiting policies).

📩 Need more capacity? ​

If you have legitimate use cases requiring higher volumes (e.g. massive synchronizations, scheduled calls), you can contact us to discuss a custom adjustment to your limits.

For any questions about rate limiting or to request a quota increase, you can contact our team by email.