Pagination et tri

Toutes les routes de liste renvoient un résultat paginé. Les mêmes quatre paramètres s'appliquent partout, ce qui permet d'écrire un seul utilitaire de parcours pour l'ensemble de l'API.

Paramètre	Type	Défaut	Rôle
page	entier	1	Numéro de page, à partir de 1
page_size	entier	10	Nombre d'éléments par page
sort_by	chaîne	created_at	Champ de tri
sort_order	asc | desc	desc	Sens du tri

curl "https://api.metaventus.com/v1/entities?entity_type=contact&page=2&page_size=50&sort_by=created_at&sort_order=asc" \
  -H "X-API-Key: VOTRE_CLE_API"

Forme de la réponse

Les éléments sont dans data, l'état de la pagination dans meta :

{
  "data": [ { "id": "…" } ],
  "meta": {
    "page": 2,
    "page_size": 50,
    "total": 1284,
    "sort_by": "created_at",
    "sort_order": "asc"
  }
}

total compte les éléments correspondant au filtre, pas ceux de la page. Le nombre de pages s'en déduit : ceil(total / page_size).

Parcourir une liste entière

Augmentez page jusqu'à recevoir moins d'éléments que page_size, ou jusqu'à dépasser total. Une page volumineuse coûte une seule requête là où des appels unitaires en consomment autant qu'il y a d'éléments — c'est ce qui fait la différence face aux limites de débit.

Tri et insertions concurrentes

Un tri décroissant sur created_at fait glisser les éléments d'une page à l'autre si des créations surviennent pendant le parcours. Pour un export fiable, triez en asc sur created_at : les nouveautés arrivent alors en fin de parcours au lieu de décaler tout ce qui suit.