Cobrança de requisições
Uma regra explica todo o resto:
Você paga quando uma transportadora dá uma resposta definitiva sobre o código rastreado. Nada além disso.
O que consome cota
| Status | code |
Situação |
|---|---|---|
200 |
— | Resposta da transportadora retornada; em /raw, o payload original pode conter um erro da transportadora |
404 |
tracking_not_found |
A transportadora foi consultada e não tem registro do código |
422 |
invalid_document |
A transportadora recebeu o documento e o recusou |
404 tracking_not_found consome cota porque a consulta foi feita: o trabalho de
perguntar à transportadora aconteceu, e a resposta — "não existe registro" — é
definitiva e útil.
O que não consome cota
Requisições rejeitadas antes de qualquer consulta. Chave ausente ou inválida
(401), conta sem assinatura ou telefone não verificado (403), endpoint
inexistente (404 not_found), método errado (405), código malformado
(400 invalid_tracking_code), retry_level inválido
(400 invalid_retry_level), transportadora fora do catálogo
(400 courier_not_supported), transportadora não identificada
(422 courier_not_detected), documento faltando (422 document_required) e
limites atingidos (429).
Falhas nossas ou da transportadora. 500, 502, 503 e 504. Não
cobramos por indisponibilidade.
Como conferir
Toda resposta traz o header X-Billable:
X-Billable: true
Depois que a cota é verificada, o consumo do período aparece no header
RateLimit, na política quota:
RateLimit: "burst";r=27;t=41, "quota";r=4318;t=1209600
Aqui, r=4318 são as requisições ainda disponíveis no período e t=1209600 os
segundos até a renovação. Veja Limites de uso.
Em planos com cota ilimitada, a política quota é omitida. O limite por minuto
continua aparecendo como burst, quando configurado.
O painel do portal mostra o mesmo número: a barra de uso do plano conta apenas requisições cobradas. Requisições não cobradas continuam visíveis na lista de chamadas recentes — elas ajudam a depurar a integração sem entrar na conta.
Limite por minuto
Os limites por minuto contam tentativas, inclusive quando a requisição é rejeitada. Isso não consome a cota do período.