Passer au contenu principal
L’API GetQR est en version bêta et réservée à certains espaces de travail. Certains détails peuvent changer avant la disponibilité générale.
L’API GetQR limite le nombre de requêtes que chaque clé API peut envoyer, pour qu’une seule intégration ne puisse pas ralentir l’API pour tout le monde.

Limites

La limite est calculée sur une fenêtre glissante d’une minute et s’applique à tous les endpoints ensemble. La vérification de l’état ne nécessite pas de clé et n’est pas comptée.

En-têtes de limite de débit

Les réponses aux requêtes avec une clé API valide incluent ces en-têtes, y compris les réponses d’erreur :

En cas de dépassement de la limite

Au-delà de la limite, l’API répond 429 avec le code rate_limit_exceeded et les mêmes en-têtes :
Attendez l’heure de réinitialisation avant d’envoyer d’autres requêtes. Ajoutez un délai aléatoire (jitter) pour que plusieurs workers ne réessaient pas au même moment, et appliquez un backoff exponentiel sur les erreurs 5xx :
Ne relancez POST /api/v1/qrs qu’avec un en-tête Idempotency-Key. Ainsi, une nouvelle tentative ne crée jamais de second QR code. Consultez Idempotence.

Rester sous la limite

  • Surveillez X-RateLimit-Remaining et ralentissez avant qu’il n’atteigne 0.
  • Utilisez les créations en masse plutôt qu’une requête par QR code.
  • Récupérez jusqu’à 100 résultats par page avec pageSize=100. Consultez Pagination.
  • Mettez en cache les images de QR codes : les téléchargements renvoient un ETag, vous pouvez donc envoyer If-None-Match et obtenir 304 Not Modified si rien n’a changé.

Et ensuite

Erreurs

QR codes