Vai al contenuto principale
L’API di GetQR è in beta ed è disponibile per alcuni workspace selezionati. I dettagli possono cambiare prima del rilascio generale.
L’API di GetQR limita il numero di richieste che ogni chiave API può inviare, così una singola integrazione non può rallentare l’API per tutti.

Limiti

Il limite viene calcolato su una finestra mobile di un minuto e si applica a tutti gli endpoint insieme. Il controllo dello stato non richiede una chiave e non viene conteggiato.

Header dei limiti di frequenza

Le risposte alle richieste con una chiave API valida includono questi header, comprese le risposte di errore:

Quando superi il limite

Oltre il limite, l’API risponde 429 con il codice rate_limit_exceeded e gli stessi header:
Attendi l’orario di azzeramento prima di inviare altre richieste. Aggiungi un jitter, così più worker non riprovano nello stesso istante, e usa un backoff esponenziale sugli errori 5xx:
Ripeti POST /api/v1/qrs solo con un header Idempotency-Key. Così un nuovo tentativo non crea mai un secondo QR code. Consulta Idempotenza.

Resta sotto il limite

  • Controlla X-RateLimit-Remaining e rallenta prima che arrivi a 0.
  • Usa le creazioni di QR in blocco invece di una richiesta per ogni QR code.
  • Recupera fino a 100 risultati per pagina con pageSize=100. Consulta Paginazione.
  • Metti in cache le immagini dei QR: i download restituiscono un ETag, quindi puoi inviare If-None-Match e ricevere 304 Not Modified se non è cambiato nulla.

Passaggi successivi

Errori

QR code