Skip to main content
Decisions (Beta)

Decision の取得

ID を指定して、判定の状態、回答、コンテキストの概要を照会します。

Decision API は現在 Beta 機能です。インターフェイス定義、レスポンス構造、動作は今後のバージョンで変更される可能性があります。ドキュメントの更新を確認し、本番環境で使用する前に互換性を検証してください。
GET /api/v1/forward/decisions/{decision_id}

リクエストヘッダー

Header必須説明
AuthorizationはいBearer <PAT or SAT>。管理者および Identity レベルの SAT をサポートします。

パスパラメーター

パラメーター型必須説明
decision_idstringはい作成 API が返した Decision ID。1～256 バイトで、先頭・末尾の空白、制御文字、/、\\、?、# を含めることはできません。
この API はクエリパラメーターを受け付けません。レコードは現在の認証スコープ内にある必要があります。

リクエスト例

curl --silent --show-error --fail-with-body \
  "https://api.qoder.com/api/v1/forward/decisions/dec_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK（失敗したレコード） 
{
  "id": "dec_xxx",
  "session_id": "sess_xxx",
  "source": "api",
  "status": "failed",
  "questions": [{
    "type": "choice",
    "name": "resolved",
    "instructions": "Has the user confirmed resolution?",
    "choices": [{"value": true}, {"value": false}]
  }],
  "answers": [],
  "context": {"mode": "session"},
  "error": {
    "code": "decision_context_unavailable",
    "message": "Session has no usable judgment context."
  },
  "created_at": "2026-10-26T10:00:00Z",
  "completed_at": "2026-10-26T10:00:01Z"
}
レスポンスフィールドは Decision オブジェクトを参照してください。成功したレコードの status は completed で、answers に判定の回答を返します。実行中のレコードは running で、completed_at は null です。 HTTP 200 は照会の成功を示し、判定の成功を示すものではありません。status、error、回答の型を確認してください。レコードを読み取っても判定は再実行されず、元のコンテキストも更新されません。

エラー

HTTPCode発生条件
400invalid_decision_inputDecision ID が無効です。
400—クエリパラメーターが指定されています。
401—認証情報が未指定、無効、または期限切れです。
403—現在の認証情報に必要なアクセス権限がありません。
404—Decision が存在しない、アクセスできない、またはレコードが削除済みです。
500—サービス内部エラー。
エラーレスポンスの構造は Decision の作成を参照してください。

関連