crisphive
RéservationsInterroger les demandes d'intervention nouvelles et modifiées (flux de synchronisation)

Interroger les demandes d'intervention nouvelles et modifiées (flux de synchronisation)

Gardez votre propre copie des réservations synchronisée SANS tout relister : renvoie les demandes d'intervention dont l'état a changé (création, transition de statut, replanification, suppression logique/archivage) à partir du curseur `since` inclus, triées de la modification la plus ancienne à la plus récente (updated_at ASC). Mode d'emploi : (1) Au premier appel, OMETTEZ `since` — le serveur initialise le curseur à « maintenant », ne renvoie aucun élément et fournit un `next_since`. (2) Stockez `next_since` et passez-le comme `since` à l'appel suivant. (3) Appliquez chaque élément renvoyé à votre base via un UPSERT sur `id` (le serveur rebalaye une fenêtre de sécurité d'environ 5 s, la même intervention peut donc réapparaître — n'ajoutez jamais aveuglément). (4) Si `has_more` vaut true, la page a atteint `limit` et d'autres changements attendent déjà — réinterrogez immédiatement ; sinon, respectez votre intervalle habituel (p. ex. 5–15 s). Ce n'est PAS de la pagination — c'est un flux de changements indexé par le temps. Utilisez le GET /job-requests paginé pour le chargement initial en masse, puis cet endpoint pour rester à jour. Les filtres (status_keys, customer_id, …) restreignent le flux à la portion qui vous intéresse.

Arguments

status_keysstringqueryoptionnel
Slugs de statut séparés par des virgules — ne remonter que les changements des interventions dans ces statuts
prioritystringqueryoptionnel
Filtre de priorité (normal|emergency)
customer_idstringqueryoptionnel
Uniquement les changements des interventions de ce client (UUID)
technician_idstringqueryoptionnel
Uniquement les changements des interventions affectées à ce technicien (UUID)
scheduled_fromstringqueryoptionnel
Filtrer à partir de (YYYY-MM-DD ou RFC3339) ; la plage est [from, to)
scheduled_tostringqueryoptionnel
Filtrer jusqu'à (YYYY-MM-DD ou RFC3339), borne exclue
sincestringqueryoptionnel
Curseur RFC3339 issu du next_since de la réponse précédente. OMETTEZ-LE au premier appel pour initialiser le curseur à l'heure serveur.
limitintegerqueryoptionnel
Nombre max de changements par appel (15 par défaut, 1000 max). Si la page est pleine, has_more=true.
GET/v1/job-requests/changes
curl -X GET "https://api.crisphive.com/v1/job-requests/changes" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

Réponses