> ## 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.

# Límites de uso

> La cuota diaria de cada socio y el límite de envíos de totales de vuelo.

## Cuota diaria

Cada socio tiene una cuota de 1.000 llamadas por día, salvo que se acuerde otra cosa. El día es el día UTC. Cuenta toda llamada autenticada, incluida la prueba de webhook.

Cada respuesta autenticada incluye:

* `X-RateLimit-Limit`: tu cuota diaria;
* `X-RateLimit-Remaining`: lo que queda de ella después de esta llamada.

Un `401`, y una ruta o un método fuera de la API de Socios, no incluyen ninguno de los dos.

Pasada la cuota, la API responde `429 rate_limited` con el motivo `rate_limited`, no hace nada y envía `Retry-After` con la fecha HTTP de la próxima medianoche UTC.

## Límite de envíos de totales de vuelo

`PUT /v1/partner/grants/{grant_id}/flight-totals` acepta un envío por grant cada 15 minutos. El servidor verifica, en este orden: un reintento del último envío aceptado (mismo `as_of`, mismos totales) responde `200` y no aplica nada; un envío cuyo `as_of` es anterior al último aceptado responde `409` con el motivo `stale_totals`; y solo después, un envío NUEVO dentro de los 15 minutos responde `429 rate_limited` con el motivo `push_throttled`, con `Retry-After` indicando el momento en que se acepta el siguiente envío. En los dos últimos casos no se aplica nada. Como un envío es un estado completo, no pierdes nada si esperas y envías el estado actual. Consulta la [guía de idempotencia](https://developers.mypilotindex.com/es/idempotency.md).

## Buenas prácticas

Concilia con `GET /v1/partner/grants` (paginando con `next_cursor`) en lugar de consultar cada grant periódicamente, y lee el resumen cuando un piloto abre tu pantalla en lugar de hacerlo con un temporizador.


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