Conceitos

Limites

Os limites de pedidos e de tamanho, e como reagir a um 429.

Os limites protegem a plataforma e as outras empresas de uma integração descontrolada. Os valores abaixo são os predefinidos; se a sua integração precisa de mais, fale connosco.

LimiteValorAo exceder
Pedidos por chave20 por segundo (rajada de 40)429 LIMITE_DE_PEDIDOS + Retry-After
Pedidos por empresa (todas as chaves e pessoas)100 por segundo (rajada de 200)429 LIMITE_DE_PEDIDOS + Retry-After
Relatórios, SAF-T e PDF em simultâneo, por empresa2 (mais 4 em fila)429
Itens por página1 a 200400 PEDIDO_INVALIDO
Corpo de um pedido2 MB413 PEDIDO_DEMASIADO_GRANDE
Linhas por documento500400 ERRO_DE_VALIDACAO
Pagamentos por documento10400 ERRO_DE_VALIDACAO
Tamanho da Idempotency-Key100 caracteres400 IDEMPOTENCIA_CHAVE_INVALIDA
Memória de uma Idempotency-Key72 horasa chave pode ser reutilizada
Chaves de API activas por empresa25criar outra pede revogar uma
Endereços permitidos por chave20—

#Reagir a um 429

  1. 1
    Pare de enviar

    Não repita já: cada tentativa gasta limite.

  2. 2
    Espere Retry-After

    O cabeçalho diz quantos segundos esperar até haver capacidade.

  3. 3
    Repita o mesmo pedido

    Com a mesma Idempotency-Key (um 429 não executou nada).

  4. 4
    Reduza o ritmo

    Uma importação grande deve limitar-se a uns 10 pedidos por segundo por chave, com poucos em paralelo.