Anleitungen›Erste Buchung erstellen
Erste Buchung erstellen
Diese Anleitung führt Sie in fünf Schritten vom API-Schlüssel bis zum gebuchten Job-Request.
1
API-Schlüssel besorgen
Erstellen Sie einen Sandbox-Schlüssel unter Settings → Developers im Dashboard. Er beginnt mit chsk_test_ und wird nur einmal bei der Erstellung angezeigt.
2
Kunden finden oder anlegen
Suchen Sie den Kunden oder legen Sie ihn an, falls er noch nicht existiert — full_name plus mindestens Telefon oder E-Mail ist erforderlich.
curl -X POST "https://api.crisphive.com/v1/customers" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{"full_name":"Lamar Bakery","email":"hello@lamarbakery.example"}'
3
Job-Typ auswählen
Listen Sie Ihren Katalog auf, um die job_type_id zu erhalten, die die Arbeit klassifiziert.
GET /v1/job-types
4
Verfügbarkeit prüfen
Rufen Sie buchbare Zeitfenster für die Termine des Kunden ab. Der Header X-Timezone ist erforderlich.
curl "https://api.crisphive.com/v1/job-requests/booking-windows?from=2026-07-02&to=2026-07-09" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "X-Timezone: America/Toronto"
5
Job-Request erstellen
Senden Sie die Buchung mit einem oder mehreren gewünschten Zeitfenstern per POST und verfolgen Sie sie anschließend über GET /v1/job-requests/{id} oder den Sync-Feed.
curl -X POST "https://api.crisphive.com/v1/job-requests" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{"customer_id":"9b2f6c3e-…","job_type_id":"5d1b3a9e-…","job_dates":[{"date":"2026-07-02","periods":[{"period":"morning"}]}]}'
AUF DIESER SEITE