> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mypilotindex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de uso

> A cota diária de cada parceiro e o limite de frequência dos totais de voo.

## Cota diária

Cada parceiro tem uma cota de 1.000 chamadas por dia, salvo acordo diferente. O dia é o dia UTC. Toda chamada autenticada conta, inclusive o teste de webhook.

Toda resposta autenticada traz:

* `X-RateLimit-Limit`: a sua cota diária;
* `X-RateLimit-Remaining`: o que resta dela depois desta chamada.

Um `401`, e um caminho ou método fora da API de Parceiros, não trazem nenhum dos dois.

Passada a cota, a API responde `429 rate_limited` com o motivo `rate_limited`, não faz nada e envia `Retry-After` com a data HTTP da próxima meia-noite UTC.

## Limite de frequência dos totais de voo

`PUT /v1/partner/grants/{grant_id}/flight-totals` aceita um envio por grant a cada 15 minutos. O servidor verifica, nesta ordem: uma repetição do último envio aceito (mesmo `as_of`, mesmos totais) responde `200` e não aplica nada; um envio cujo `as_of` é anterior ao último aceito responde `409` com o motivo `stale_totals`; e só então um envio NOVO dentro dos 15 minutos responde `429 rate_limited` com o motivo `push_throttled`, com `Retry-After` indicando o momento em que o próximo envio será aceito. Nos dois últimos casos nada é aplicado. Como um envio é um estado completo, você não perde nada esperando e enviando o estado atual. Veja o [guia de idempotência](https://developers.mypilotindex.com/pt-br/idempotency.md).

## Cotas de publicação

Posts, stories e vagas têm cotas em janela móvel de 24 horas além da cota diária, e elas contam o que foi publicado, removido ou não:

| Publicação | Cota |
| - | - |
| Posts como piloto | 3 por grant |
| Stories como piloto | 5 por grant |
| Posts de organização | 10 por parceiro |
| Vagas | 50 por parceiro |

Passadas essas cotas, a API responde `429 rate_limited` com o motivo `publication_throttled` e `Retry-After`. Uma repetição de um `client_ref` que você já usou continua respondendo, seja qual for a situação da cota.

## Boas práticas

Reconcilie com `GET /v1/partner/grants` (paginando com `next_cursor`) em vez de consultar cada grant periodicamente, e leia o resumo quando um piloto abrir a sua tela, não em intervalos fixos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.