Pagination et format des réponses

Toutes les listes de l'API se paginent de la même façon, et toutes les réponses suivent la même enveloppe.

Paginer une liste

Deux paramètres de requête contrôlent la pagination :

Paramètre	Défaut	Maximum	Rôle
limit	20	100	Nombre d'éléments par page
offset	0	Aucun	Nombre d'éléments à sauter

Par exemple, la deuxième page de 50 factures :

curl -H "Authorization: Bearer nsk_live_…" \
     "https://app.naskel.io/api/v1/invoices?limit=50&offset=50"

L'enveloppe d'une liste

Une réponse de liste contient les éléments dans data et les informations de pagination dans pagination :

{
  "data": [ /* … */ ],
  "pagination": { "total": 128, "limit": 20, "offset": 0 }
}

L'enveloppe d'un objet

Un appel qui renvoie un seul objet l'enveloppe dans data :

{ "data": { /* … */ } }

Les dates

Toutes les dates sont au format ISO 8601, en UTC :

2026-06-02T10:00:00.000Z

Voir aussi

• Limites de débit
• Factures