Skip to main content

Principe de pagination

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

  1. Effectuer la première requête
  2. Traiter les items de la page
  3. Vérifier si _next est présent et non vide
  4. Si oui, requêter _next et retourner à l’étape 2
  5. 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.