예약›작업 요청 생성
작업 요청 생성
현장 서비스 작업을 예약합니다 — 디스패치 및 스케줄링 파이프라인에 진입하는 워크 오더입니다. 고객의 UUID와 함께 요청 `job_dates`(날짜 + 오전/오후/저녁 시간대, 가급적 GET /job-requests/booking-windows에서 제공된 값)를 전송하고, 선택적으로 `job_type_id`(서비스 카탈로그), `skill_ids`(필요한 기술자 자격) 및 자유 텍스트 설명을 전달하십시오. 이후 견적, 기술자/크루 배정, 완료를 거쳐 워크 오더가 비즈니스의 워크플로를 따라 진행됩니다.
인수
X-Timezonestringheader선택
고객의 IANA 타임존
Idempotency-Keystringheader선택
Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate
customer_idstringbody필수
작업을 예약할 이 비즈니스의 기존 고객 UUID입니다. 필수입니다.
descriptionstringbody선택
요청된 작업에 대한 자유 텍스트 설명입니다. 선택 사항이며, 최대 2000자입니다.
▾job_datesarray<object>body필수
고객이 작업을 원하는 요청 날짜 및 시간대입니다. 최소 1개, 최대 12개까지 지정할 수 있습니다.
job_type_idstringbody선택
이 작업을 분류할 작업 유형의 UUID입니다. 선택 사항이며, null이면 작업이 미분류 상태로 유지됩니다.
priorityenumbody선택
스케줄링 우선순위. 선택 사항이며, 생략하면 비즈니스의
default_priority 설정(배정 설정, 기본값 p2)이 적용됩니다. p0=긴급
(인터럽트 기반 삽입), p1=최상위(p0에 의해서만 밀려남), p2=표준,
p3=연기 가능(가장 먼저 밀려나는 후보).
skill_idsarray<string>body선택
고객이 이 작업에 원하는 기술(skill)의 UUID 목록입니다. 선택 사항이며, 최대 20개까지 지정할 수 있습니다.
sla_deadlinestringbody선택
SLA 마감 기한(비즈니스 로컬 naive datetime, 예: "2026-07-15T17:00:00").
선택 사항이며 priority=p1과 함께일 때만 유효합니다 — 자동 에스컬레이션
시계를 작동시킵니다(위반 위험이 비즈니스의 안전 버퍼를 넘으면 작업이
p0로 에스컬레이션됨). 미래 시각이어야 합니다.
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" }'
요청 본문
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"priority": ,
"skill_ids": [
],
"sla_deadline":
}
Bearer