Passer au contenu principal
Les points d’accès de liste supportent la pagination pour gérer efficacement les grands ensembles de résultats.

Paramètres de pagination

ParamètreTypeDéfautDescription
pageentier0Numéro de page (indexé à partir de 0)
sizeentier10Nombre de résultats par page (1-100)

Exemple de requête

curl -X GET "https://api.withallo.com/v1/api/contacts?page=0&size=20" \
  -H "Authorization: Api-Key VOTRE_CLE_API"

Métadonnées de réponse

Les réponses paginées incluent des métadonnées sur la page actuelle :
{
  "data": {
    "results": [...],
    "metadata": {
      "pagination": {
        "total_pages": 5,
        "current_page": 0
      }
    }
  }
}

Parcourir les pages

Pour récupérer tous les résultats, incrémentez le paramètre page jusqu’à atteindre total_pages :
let currentPage = 0;
let totalPages = 1;

while (currentPage < totalPages) {
  const response = await fetch(
    `https://api.withallo.com/v1/api/contacts?page=${currentPage}&size=100`,
    { headers: { "Authorization": "Api-Key VOTRE_CLE_API" } }
  );
  
  const data = await response.json();
  totalPages = data.data.metadata.pagination.total_pages;
  
  // Traiter data.data.results
  
  currentPage++;
}