429.
Os limites são aplicados por api-key.
A avaliação segue a prioridade das regras: grupos específicos são avaliados antes dos prefixos mais genéricos (corridas/* e, por fim, /api/v2/integracao/*).
O limite é contado por grupo de endpoints, e não por endpoint isolado: todas as chamadas às rotas de um mesmo grupo somam no mesmo contador. Por exemplo, chamar /api/v2/integracao/corridas/estimativas, /api/v2/integracao/corridas/programadas/estimativas e /api/v2/integracao/corridas/empresas com a mesma chave em menos de um minuto consome 3 requisições do grupo “Estimativas e empresas”, e não 1 de cada endpoint.
Os valores da tabela são limites base. O limite efetivo de cada grupo é o limite base multiplicado pela faixa da central. A faixa é um multiplicador inteiro, a partir de 1, definido para cada central. Por isso, na coluna Limite, os valores aparecem como limite base * faixa. Quando a central não possui faixa definida, vale a faixa 1.
O limite de mensagens da corrida vale para o envio; a leitura (
/api/v2/integracao/mensagens/corridas/passageiro/* e /api/v2/integracao/mensagens/corridas/condutor/*) segue o limite Padrão.
Limites por recurso
Alguns endpoints têm, além do limite do grupo, um limite por recurso informado na requisição: a mesmaapi-key só pode operar o mesmo recurso, identificado na requisição, um número fixo de vezes por minuto. Esses limites são fixos e não são multiplicados pela faixa.
Nas notificações, o envio individual conta por
passageiro_id, e no envio em lote o conjunto de passageiros informado em passageiros é tratado como um único recurso: o mesmo conjunto só pode receber 4 envios por minuto. Lotes com mais de 100 passageiros contam apenas no limite do grupo.
A criação de cupons em lote (/api/v2/integracao/cupons/lote) não entra no limite por gerador: cada requisição conta uma vez no grupo “Cupons em lote”, qualquer que seja a quantidade de cupons e de geradores do lote.
Requisições sem identificador (por exemplo, listagens por filtro) contam apenas no limite do grupo. Os limites valem ao mesmo tempo: exceder qualquer um deles retorna 429. O contador por recurso é separado para cada api-key, então o consumo de um integrador não afeta o de outro.
Headers de rate limit
Nas respostas dos endpoints com limite de bloqueio configurado, o gateway informa o consumo da janela atual. Use esses headers para se auto-regular antes de receber429.
Quando mais de um limite de bloqueio se aplica à requisição (por exemplo, o do grupo e um limite por recurso), os headers refletem o mais restritivo (o de menor saldo).
Não existe header de reset: como a contagem usa janela deslizante, não há um instante único de zeragem do contador. Na resposta
429, o tempo de espera continua sendo indicado pelo header Retry-After, em segundos.