Paginado y rate limit

Cómo recorrer resultados paginados y qué esperar de los límites de uso de la API.

Paginado

Los endpoints de listado devuelven los resultados en páginas. Controla la paginación con dos parámetros de query:

Parámetro	Descripción
page	Número de página a consultar.
per_page	Cantidad de resultados por página.

curl "https://api.emify.co/api/companies/{company_id}/invoices?page=1&per_page=50" \
  -H "X-Api-Key: tu_api_key"

La respuesta incluye los datos y los metadatos de paginación:

{
  "data": [ { "...": "..." } ],
  "current_page": 1,
  "per_page": 50,
  "total": 85,
  "last_page": 2
}

Campo	Descripción
data	Registros de la página actual.
current_page	Página devuelta.
per_page	Resultados por página.
total	Cantidad total de registros.
last_page	Última página disponible.

Recorre las páginas incrementando page hasta llegar a last_page.

El listado de documentos admite además filtros como invoice_type, status, invoice_date_from, invoice_date_to, number y recipient_document_number. Consulta la referencia de la API para la lista completa.

Rate limit

Diseña tu integración para reintentar con backoff ante respuestas 5xx y para no emitir ráfagas innecesarias de peticiones. Los límites de uso concretos se documentarán aquí cuando estén definidos.