Pagination
Chaque endpoint de liste est paginé avec les deux mêmes paramètres de query :
La réponse enveloppe la page :
Filtres
- Les filtres sont des paramètres de query (
?origin=peppol,?type=company…). Chaque endpoint de liste documente les siens dans la référence API. - Les filtres d’énumération acceptent une liste séparée par des virgules,
interprétée comme un OU logique :
?origin=manual,peppol,mail. - Une valeur de filtre inconnue renvoie
400 invalid_filteravec les valeurs admises dans le message.
Récupérer toutes vos données
offset est plafonné à 10000 — une protection du service : paginer très profond
par offset est coûteux. Ce plafond n’empêche pas une récupération complète :
- Documents — la seule ressource volumineuse : découpez par fenêtres de dates
avec
issue_date_from/issue_date_to(une année à la fois, par exemple) et paginez à l’intérieur de chaque fenêtre.totalvous dit quand une fenêtre doit être resserrée. - Les autres ressources restent très en dessous du plafond (quelques comptes bancaires, journaux ou adresses de livraison par entreprise).