Limite de requisições

1.000 requisições por minuto, por conta, em janela fixa alinhada ao minuto do relógio.

1.000 requisições por minuto, por conta, em janela fixa alinhada ao minuto do relógio.

Toda resposta traz:

x-ratelimit-limit: 1000
x-ratelimit-remaining: 987
x-ratelimit-reset: 1782950460

x-ratelimit-reset é o horário (Unix, em segundos) em que a janela reabre.

O teto é da conta, não da chave. Todas as chaves da mesma conta dividem o mesmo balde — criar uma segunda chave não dobra o seu limite.

⛒ Existe um SEGUNDO 429, e ele não é da sua conta. Antes da autenticação, há uma proteção por endereço de rede (1.200 por minuto, por IP). Quando é ela que recusa, a mensagem cita "este IP" e os cabeçalhos vêm com o sufixo -ip:

x-ratelimit-limit-ip: 1200
x-ratelimit-remaining-ip: 0
x-ratelimit-reset-ip: 1782950460

⛔ Se o seu código lê x-ratelimit-reset para calcular a espera, nesse caso ele lê undefined — o cabeçalho sem sufixo não existe nessa resposta. Trate os dois 429 igual: espere e repita. ⛒ Duas contas atrás do mesmo IP de saída (escritório, NAT corporativo, o mesmo servidor rodando duas integrações) somam neste balde, e é por isso que ele é maior que o da conta.

Recomendações:

  • Reaja ao 429, não ao remaining. Entre você ler o remaining e fazer a próxima chamada, outra máquina sua pode ter consumido a cota.
  • Use espera exponencial (backoff) ao receber 429.
  • Nas respostas 401, os três cabeçalhos saem com valores indicativos — como a chave nem chegou a ser identificada, não há contador real para consultar.

⛔ Editar em lote consome uma requisição POR ITEM. PATCH …/batch executa cada item pelo mesmo caminho da edição unitária, e cada um paga a própria cota: um lote de 100 itens consome ~101 do seu minuto, não 1. ⛒ Criar em lote (POST …/batch) NÃO tem esse custo — ele paga uma vez só. Dez lotes de 100 edições estouram o minuto no décimo, e de fora parecem dez chamadas.

Tamanho do corpo

Todo POST/PATCH aceita no máximo 64 KB. A única exceção é o envio em lote (seção 14), que aceita 512 KB.