Guías prácticas›Cree su primera reserva
Cree su primera reserva
Esta guía le lleva de principio a fin, desde una clave de API hasta una solicitud de trabajo reservada, en cinco pasos.
1
Obtenga su clave de API
Cree una clave de sandbox en Settings → Developers en su panel. Comienza con chsk_test_ y se muestra una sola vez al crearla.
2
Busque o cree el cliente
Busque el cliente, o cree uno si aún no existe — se requiere full_name más al menos uno entre teléfono/correo electrónico.
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
Elija un tipo de trabajo
Liste su catálogo para obtener el job_type_id que clasifica el trabajo.
GET /v1/job-types
4
Verifique la disponibilidad
Obtenga las ventanas reservables para las fechas del cliente. El encabezado X-Timezone es obligatorio.
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
Cree la solicitud de trabajo
Envíe la reserva con una o más ventanas de fechas solicitadas y luego haga el seguimiento mediante GET /v1/job-requests/{id} o el feed de sincronización.
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"}]}]}'
EN ESTA PÁGINA