Réservations›Créer une demande d'intervention
Créer une demande d'intervention
Réserve une intervention de terrain — l'ordre de travail qui entre dans le pipeline de dispatch et de planification. Envoyez l'UUID du client plus les `job_dates` demandées (date + périodes matin/après-midi/soir, idéalement proposées depuis GET /job-requests/booking-windows), un `job_type_id` facultatif (catalogue de services), des `skill_ids` (qualifications techniciens requises) et une description libre. Le devis, l'affectation du technicien/de l'équipe et la clôture font ensuite progresser l'ordre de travail dans le workflow de l'entreprise.
Arguments
X-Timezonestringheaderoptionnel
Fuseau horaire IANA du client
Idempotency-Keystringheaderoptionnel
Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate
customer_idstringbodyrequis
UUID d'un client existant de cette entreprise pour lequel réserver l'intervention. Requis.
descriptionstringbodyoptionnel
Description libre des travaux demandés. Facultative ; 2000 caractères max.
▾job_datesarray<object>bodyrequis
Date(s) et période(s) souhaitées par le client pour l'intervention. Au moins une, jusqu'à 12.
job_type_idstringbodyoptionnel
UUID du type d'intervention pour classer cette intervention. Facultatif ; null laisse l'intervention non classée.
priorityenumbodyoptionnel
Priorité de planification. Facultatif ; les réservations sans valeur reçoivent le paramètre
default_priority de l'entreprise (paramètres d'affectation, p2 par défaut). p0=urgence
(insertion prioritaire), p1=haute (déplacée uniquement par p0), p2=standard,
p3=reportable (premier candidat au déplacement).
skill_idsarray<string>bodyoptionnel
UUID des compétences souhaitées par le client pour cette intervention. Facultatif ; jusqu'à 20.
sla_deadlinestringbodyoptionnel
Échéance SLA (date-heure locale de l'entreprise, naïve, p. ex. "2026-07-15T17:00:00").
Facultatif ; UNIQUEMENT valide avec priority=p1 — arme l'horloge d'auto-escalade
(l'intervention passe à p0 lorsque le risque de dépassement franchit la marge
de sécurité de l'entreprise). Doit être dans le futur.
POST/v1/job-requests
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-1a4d-4f0a-8f2e-7c5d1b3a9e01", "description": "Please call on arrival.", "job_dates": [ { "date": "2030-06-03", "periods": [ { "business_view": [], "period": "morning" } ] } ], "job_type_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "priority": "p1", "skill_ids": [ "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" ], "sla_deadline": "2030-06-14T17:00:00" }'
Corps de la requête
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"priority": ,
"skill_ids": [
],
"sla_deadline":
}
Bearer