Pular para o conteúdo principal
A API do GetQR está em beta e disponível para workspaces selecionados. Os detalhes podem mudar antes do lançamento oficial.
A API do GetQR limita quantas requisições cada chave de API pode enviar, para que uma única integração não deixe a API lenta para todos.

Limites

O limite é contado em uma janela deslizante de um minuto e vale para todos os endpoints juntos. A verificação de status não precisa de chave e não conta.

Cabeçalhos de limite

As respostas a requisições com uma chave de API válida trazem estes cabeçalhos, inclusive as respostas de erro:

Quando você ultrapassa o limite

Acima do limite, a API responde 429 com o código rate_limit_exceeded e os mesmos cabeçalhos:
Aguarde o horário de reinício antes de enviar mais requisições. Adicione jitter para que vários workers não tentem de novo no mesmo instante, e use backoff exponencial em erros 5xx:
Só repita POST /api/v1/qrs com um cabeçalho Idempotency-Key. Assim, uma nova tentativa nunca cria um segundo QR code. Veja Idempotência.

Fique abaixo do limite

  • Acompanhe X-RateLimit-Remaining e reduza o ritmo antes que chegue a 0.
  • Use a criação de QR codes em massa em vez de uma requisição por QR code.
  • Busque até 100 resultados por página com pageSize=100. Veja Paginação.
  • Faça cache das imagens de QR: os downloads retornam um ETag, então você pode enviar If-None-Match e receber 304 Not Modified quando nada mudou.

Próximos passos

Erros

QR codes