Crisphive
ja
予約›P0 緊急挿入のためのテクニシャンのランク付け

P0 緊急挿入のためのテクニシャンのランク付け

指定した開始時刻に緊急ジョブを担当できるテクニシャンを、到着が最速の順（P0 ではルート効率よりも到着が優先されます）でランク付けして返します。レスポンスには、過去実績に基づく `crew_recommendation`（比較可能な完了ジョブでのクルー人数の中央値 + 必須の免責事項 — AC-2）も含まれます。予約が入っているテクニシャンも候補になります — 各エントリには、そのテクニシャンにコミットした場合に発生する押しのけプレビュー（どの低優先度ジョブが日ごとに押しのけられるか）が含まれ、total_moves=0 は空き枠を意味します。P0 ジョブが押しのけられることは決してなく、P1 は P0 によってのみ押しのけられます。ETA はテクニシャンの開始地点から推定されます（ライブ GPS はありません）。選んだ technician_id を emergency/preview と emergency/commit に渡してください。 409 の次のステップ: EMERGENCY_RESCHEDULE_NOT_ELIGIBLE — ジョブを緊急挿入できません（P0 でない、既に開始/完了/アーカイブ済み、または未見積もり）: ジョブの状態を修正するか、通常の確定を使用してください。EMERGENCY_RESCHEDULE_CREW_UNSUPPORTED — クルージョブは緊急フローを使用できません（v1）: 代わりに確定/再割り当てで人員を手配してください。EMERGENCY_RESCHEDULE_NO_WORKING_DAY — 選んだ日に勤務時間がありません: 勤務日を選んでください。EMERGENCY_RESCHEDULE_IN_PAST — 開始時刻が既に過ぎています: 未来の時刻を選んでください。

引数

emergency_job_idstringbody必須
ID of the P0 job to place.
limitintegerbody任意
返す候補の最大数（デフォルト 5、最大 10）です。
modeenumbody必須
Cascade mode each candidate's displacement preview assumes: overtime = displaced jobs stay same-day; next_day = overflow rolls to the next working day.
start_atstringbody必須
Desired start — business-local naive datetime, no offset. Must be in the future.
POST/v1/job-requests/emergency/candidates
curl -X POST "https://api.crisphive.com/v1/job-requests/emergency/candidates" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "emergency_job_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "limit": 1,
  "mode": "overtime",
  "start_at": "2030-06-14T09:00:00"
}'
リクエストボディ
{
"emergency_job_id": ,
"limit": ,
"mode": ,
"start_at":
}

レスポンス

‹新規・変更されたジョブリクエストのポーリング（同期フィード）前へ
緊急挿入 + カスケード日程変更のコミット›次へ