naskel
APIMis à jour le

Pagination et format des réponses

Paramètres limit et offset, enveloppe des listes et des objets, et format des dates.

French only for now

This page has not been translated yet. You are reading the French version.

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ètreDéfautMaximumRôle
limit20100Nombre d'éléments par page
offset0AucunNombre 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