Guides pratiques›Créer votre première réservation
Créer votre première réservation
Ce guide vous accompagne de bout en bout, de la clé API à une demande d’intervention réservée, en cinq étapes.
1
Obtenez votre clé API
Créez une clé de bac à sable sous Settings → Developers dans votre tableau de bord. Elle commence par chsk_test_ et n’est affichée qu’une seule fois à la création.
2
Trouvez ou créez le client
Recherchez le client, ou créez-en un s’il n’existe pas encore — full_name plus au moins un téléphone ou un e-mail est requis.
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
Choisissez un type d’intervention
Listez votre catalogue pour récupérer le job_type_id qui classifie le travail.
GET /v1/job-types
4
Vérifiez les disponibilités
Récupérez les créneaux réservables pour les dates du client. L’en-tête X-Timezone est obligatoire.
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
Créez la demande d’intervention
Envoyez la réservation avec un ou plusieurs créneaux de dates souhaités, puis suivez-la via GET /v1/job-requests/{id} ou le flux de synchronisation.
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"}]}]}'
SUR CETTE PAGE