<aside> 🧩

Public API Reference / Verified 2026-08-12

このページはLOG Algorithm APIの外部向けReferenceです。2026-08-12に実装正本 logposeTech/deliver の docs/spec/API_SPECIFICATION.md と突合しています。内部実装詳細ではなく、外部クライアントが依存できる契約だけを記載します。

</aside>

配車API

`POST /sessions?callback_url=...`

配車リクエストを非同期で受け付けます。

認証

Api-Key ヘッダーが必須です。発行済みのAPIキーを指定してください。

リクエスト

multipart/form-data で以下の4ファイルを送信します。

フィールド	内容
`config`	配車設定JSON
`input`	配車対象データJSON
`relax_constraints`	制約緩和設定JSON
`algo_preset`	アルゴリズムプリセットJSON

callback_url は必須です。配車処理完了後、このURLへ結果が通知されます。

curl -X POST \
  -H "Api-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "relax_constraints=@relax_constraints.json" \
  -F "algo_preset=@algo_preset.json" \
  "YOUR_API_BASE_URL/sessions?callback_url=YOUR_CALLBACK_URL"

<aside> ℹ️

旧ドキュメントにあった hp_mode は現行routingには使用しません。新規実装では指定しないでください。

</aside>

受付成功レスポンス

{
  "status": "queued",
  "session_id": "<session id>",
  "callback_url": "<callback url>"
}

主なHTTPステータス

Status	意味
`200`	受付成功
`400`	必須入力不足・入力不正
`401`	APIキー認証失敗
`500`	サーバー内部エラー

セッション状態取得

`GET /sessions/{session_id}`

指定した配車セッションの現在状態を取得します。

正常時の例：