Lors de la récupération de données via l’Aircall API, les endpoints de liste renvoient les résultats à l’aide d’un système de pagination. Cette approche permet de gérer de grands volumes de données en divisant les réponses en plusieurs pages et en fournissant des informations de navigation pour chacune d’elles.

Principes de base de la pagination

Les informations de pagination sont incluses dans l’objet meta de la réponse de l’API. Cet objet fournit des informations clés sur le jeu de données actuel et la navigation :

  • count : Nombre d’éléments dans la page actuelle

  • total : Nombre total d’éléments correspondant à la requête

  • current_page : Numéro de la page actuelle

  • per_page : Nombre d’éléments renvoyés par page

  • next_page_link / previous_page_link : Liens pour naviguer entre les pages

Vous pouvez contrôler la pagination à l’aide des paramètres de requête suivants :

  • page : Numéro de page (par défaut : 1)

  • per_page : Nombre de résultats par page (par défaut : 20, maximum : 50)

Exemple

GET /v1/calls?page=2&per_page=50

Limite de 10 000 enregistrements

Pour des raisons de performance, les endpoints de liste de l’Aircall API sont limités à un maximum de 10 000 enregistrements par requête, même lorsque la pagination est utilisée.

Cette limite s’applique aux endpoints qui renvoient des collections de ressources, notamment :

  • Lister tous les appels

  • Lister tous les contacts

  • Autres endpoints de liste similaires

Si plus de 10 000 enregistrements correspondent à une requête, l’API ne renverra que les 10 000 premiers résultats. Les pages au-delà de cette limite ne sont pas accessibles.

Important: Les paramètres de pagination tels que page et per_page ne permettent pas de contourner la limite de 10 000 enregistrements.

Récupérer plus de 10 000 enregistrements

Pour récupérer des volumes de données plus importants, divisez vos requêtes en utilisant les filtres disponibles, comme les paramètres basés sur le temps.

Par exemple, l’endpoint /v1/calls prend en charge :

  • from : Date minimale de création de l’appel (horodatage UNIX)

  • to : Date maximale de création de l’appel (horodatage UNIX)

En interrogeant des plages de temps plus courtes, par exemple des intervalles hebdomadaires ou mensuels, chaque requête peut rester en dessous de la limite de 10 000 enregistrements tout en permettant une récupération complète des données.

Exemple

GET /v1/calls?from=<timestamp>&to=<timestamp>
Conseil: Divisez les requêtes volumineuses en plages de temps plus petites afin de garantir que chaque requête reste dans la limite des 10 000 enregistrements.

Notes complémentaires

  • La valeur maximale de per_page est de 50.

  • Les paramètres de pagination ne permettent pas d’accéder au-delà de 10 000 enregistrements.

  • Certains endpoints, comme ceux relatifs aux appels, peuvent inclure des contraintes supplémentaires, telles qu’une disponibilité historique limitée.