সীমা ও ত্রুটি
কিছু ব্যর্থ হলে API যা ফেরত দেয়।
কী প্রতি সীমা: মিনিটে 120 অনুরোধ; এর উপরে Retry-After সহ 429। তালিকা: পৃষ্ঠায় সর্বোচ্চ ২০০ আইটেম (limit), এবং সব আবার না ঘুরতে ইনক্রিমেন্টাল মোড (desde + depoisDe)। প্রতিটি ত্রুটি JSON-এ "erro" ক্ষেত্রসহ ফেরে যা করণীয় বলে।
Os tetos
| Limite | Valor | Nota |
|---|---|---|
| Requisições por minuto, por chave | 120 | Acima disso: 429 com Retry-After: 60. |
| Itens por página (limit) | 200 | Padrão 50. Pedido acima do teto usa o teto. |
| Itens por chamada de lote | 200 | Acima disso: 413 e a orientação para dividir. |
| Linhas por consulta analítica | 1000 | Acima disso, a resposta vem com truncado=true. |
| Validade de uma Idempotency-Key | 24 h | 24 horas, para corpos de até 2 MB. |
Como reagir ao 429
Espere o tempo do Retry-After e repita com recuo exponencial (1, 2, 4, 8 segundos...). Nunca repita em laço fechado: as chamadas recusadas também contam.