予約›ジョブリクエストの作成
ジョブリクエストの作成
フィールドサービスのジョブを予約します。これはディスパッチとスケジューリングのパイプラインに入るワークオーダーです。顧客の UUID と、希望する `job_dates`（日付 + morning/afternoon/evening の時間帯。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任意
このジョブで顧客が希望するスキルの UUID です。省略可能。最大 20 件まで指定できます。
sla_deadlinestringbody任意
SLA 期限（ビジネスローカルのナイーブな日時、例: "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