Les ressources retournant beaucoup de résultats sont automatiquement paginées pour optimiser les performances.
Utilisation du champ _next
Le champ _next dans la réponse contient l’URL de la page suivante.
Exemple de réponse paginée
Parcourir toutes les pages
Algorithme de base
- Effectuer la première requête
- Traiter les
items de la page
- Vérifier si
_next est présent et non vide
- Si oui, requêter
_next et retourner à l’étape 2
- Si non, toutes les pages ont été parcourues
Exemple en Python
Exemple en Shell
Ressources paginées
Les ressources suivantes sont paginées :
- Collection de jobs (
/restapi/v1/job)
- Collection de candidats (
/restapi/v1/candidate)
- Collection de candidatures par job (
/restapi/v1/job/{id}/application)
- Collection de candidatures par candidat (
/restapi/v1/candidate/{id}/application)
- Collection des changements d’étapes (
/restapi/v1/step)
- Collection des notes (
/restapi/v1/note)
- Historique des webhooks (
/restapi/v1/webhook/task)
Ressources non paginées
Certaines ressources retournent toutes les données en une seule réponse :
- Détails d’un job (
/restapi/v1/job/{id})
- Détails d’un candidat (
/restapi/v1/candidate/{id})
- Détails d’une candidature (
/restapi/v1/application/{id})
- Équipe d’un job (
/restapi/v1/job/{id}/team)
- Liste des processus (
/restapi/v1/process)
N’essayez pas de deviner la taille des pages ou de manipuler le curseur de pagination. Utilisez toujours l’URL fournie par _next.