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.
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.
Buenas prácticas
Concilia conGET /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.