crisphive
BuchungenNeue und geänderte Auftragsanfragen abfragen (Sync-Feed)

Neue und geänderte Auftragsanfragen abfragen (Sync-Feed)

Halten Sie Ihre eigene Kopie der Buchungen synchron, OHNE alles neu aufzulisten: Gibt die Auftragsanfragen zurück, deren Zustand sich ab dem `since`-Cursor geändert hat (erstellt, Statusübergang, Terminverschiebung, Soft-Delete/Archivierung), sortiert nach ältester Änderung zuerst (updated_at ASC). So verwenden Sie den Endpunkt: (1) LASSEN Sie beim ersten Poll `since` WEG — der Server initialisiert den Cursor auf "jetzt", gibt keine Einträge und ein `next_since` zurück. (2) Speichern Sie `next_since` und übergeben Sie es beim nächsten Poll als `since`. (3) Übernehmen Sie jeden zurückgegebenen Eintrag per UPSERT über `id` in Ihren Datenbestand (der Server scannt ein Sicherheitsfenster von ca. 5 s erneut, sodass derselbe Auftrag mehrfach erscheinen kann — niemals blind anhängen). (4) Wenn `has_more` true ist, wurde die Seite bis `limit` gefüllt und weitere Änderungen warten bereits — pollen Sie sofort erneut; andernfalls warten Sie Ihr übliches Intervall ab (z. B. 5–15 s). Dies ist KEINE Pagination — es ist ein zeitbasierter Änderungs-Feed. Verwenden Sie das paginierte GET /job-requests für den initialen Massenabruf und anschließend diesen Endpunkt, um aktuell zu bleiben. Filter (status_keys, customer_id, …) grenzen den Feed auf den für Sie relevanten Ausschnitt ein.

Argumente

status_keysstringqueryoptional
Kommagetrennte Status-Slugs — nur Änderungen an Aufträgen in diesen Statuswerten anzeigen
prioritystringqueryoptional
Prioritätsfilter (normal|emergency)
customer_idstringqueryoptional
Nur Änderungen an den Aufträgen dieses Kunden (UUID)
technician_idstringqueryoptional
Nur Änderungen an Aufträgen, die diesem Techniker zugewiesen sind (UUID)
scheduled_fromstringqueryoptional
Filter ab (YYYY-MM-DD oder RFC3339); Bereich ist [from, to)
scheduled_tostringqueryoptional
Filter bis (YYYY-MM-DD oder RFC3339), exklusiv
sincestringqueryoptional
RFC3339-Cursor aus dem next_since der vorherigen Antwort. Beim ersten Poll WEGLASSEN, um den Cursor auf die Serverzeit zu initialisieren.
limitintegerqueryoptional
Max. Änderungen pro Poll (Standard 15, max. 1000). Wenn die Seite voll ist, ist 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"

Antworten