Limites de débit#

Chaque clé API dispose de son propre budget, appliqué par deux limites qui s’appliquent ensemble. Une requête doit satisfaire les deux :

Sur une instance auto-hébergée, ces valeurs sont configurables avec API_THROTTLE_BURST et API_THROTTLE_SUSTAINED, voir Configuration.

Lorsque vous dépassez une limite#

Dépasser l’une ou l’autre limite renvoie :

HTTP 429 Too Many Requests

{ "detail": "Request was throttled. Expected available in 12 seconds." }

DRF inclut un indice Retry-After dans le message ; reculez et réessayez après le délai indiqué. Un client robuste devrait gérer 429 avec un recul exponentiel.

Comptabilité des usages#

Chaque requête de recherche compte dans le total mensuel de recherches du propriétaire de la clé (le même total affiché pour les recherches sur le site web dans Paramètres). Cela inclut :

web/, images/, images/similar/ (uniquement lorsqu’une vraie recherche s’exécute), news/, videos/, maps/, translate/, translate/languages/, instant/, cards/ et suggest/.

Les points de terminaison méta ne comptent pas dans l’usage :

• La racine API (/api/v1/)
• status/
• key/

Vous pouvez donc interroger key/ ou status/ librement pour vérifier l’état de santé sans dépenser votre budget de recherches (ils comptent quand même contre la limite de débit brute).