Skip to main content
Decisions (Beta)

Decisions の一覧取得

現在の認証スコープ内の判定レコードをページ単位で取得します。Session で絞り込むこともできます。

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

リクエストヘッダー

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

クエリパラメーター

パラメーター型必須デフォルト説明
session_idstringいいえ—この Session の判定レコードのみを取得します。Session は現在の認証スコープ内にあり、アーカイブされていない必要があります。
after_idstringいいえ—前ページの last_id を渡し、古いレコードの方向へページを進めます。
before_idstringいいえ—現在のページの first_id を渡し、新しいレコードの方向へページを進めます。
limitintegerいいえ201 ページの件数。範囲は 1～100。
各パラメーターは 1 回のみ指定でき、空にすることはできません。after_id と before_id は同時に指定できません。ID パラメーターは 1～256 バイトで、先頭・末尾の空白、制御文字、/、\\、?、# を含めることはできません。identity_id、status、order など、ほかのクエリパラメーターは受け付けません。

リクエスト例

現在のスコープ内のレコードを照会します。 
curl --silent --show-error --fail-with-body \
  "https://api.qoder.com/api/v1/forward/decisions?limit=20" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"
Session の次ページを照会します。after_id には前ページが返した last_id を使用します。 
curl --silent --show-error --fail-with-body --get \
  "https://api.qoder.com/api/v1/forward/decisions" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  --data-urlencode "session_id=sess_xxx" \
  --data-urlencode "after_id=dec_xxx" \
  --data-urlencode "limit=20"

レスポンス例

HTTP 200 OK（実行中のレコードを含む） 
{
  "data": [{
    "id": "dec_xxx",
    "session_id": "sess_xxx",
    "source": "api",
    "status": "running",
    "questions": [{
      "type": "choice",
      "name": "resolved",
      "instructions": "Has the user confirmed resolution?",
      "choices": [{"value": true}, {"value": false}]
    }],
    "answers": [],
    "context": {"mode": "session"},
    "error": null,
    "created_at": "2026-10-26T10:00:00Z",
    "completed_at": null
  }],
  "has_more": false,
  "first_id": "dec_xxx",
  "last_id": "dec_xxx"
}

レスポンスフィールドとページネーション

フィールド型説明
dataarray現在のページの Decision オブジェクト。running、completed、failed のレコードを含む場合があります。
has_moreboolean現在の照会方向にさらにレコードがあるかどうか。デフォルトと after_id は古い方向、before_id は新しい方向を示します。
first_idstring または null現在のページの最初のレコード ID。空のページでは null。
last_idstring または null現在のページの最後のレコード ID。空のページでは null。
すべてのページは作成日時の新しい順で返され、同じ日時の場合はサーバーの安定した順序が使われます。連続してページを取得する際は、同じ認証スコープとフィルター条件を維持し、サーバーが返した順序を保持してください。カーソルは現在のスコープに属し、現在の session_id フィルターに一致する必要があります。一致しない場合は 404 を返します。 session_id を省略すると、明示的な state 入力と Session 入力の両方から生成されたレコードを返すことができます。Identity レベルの SAT は、紐付けられた Identity のスコープ内のレコードのみ取得できます。

エラー

HTTPCode発生条件
400invalid_decision_input または Code なしパラメーターの重複、空値、未知のパラメーター、形式不正、limit の範囲外、または両カーソルの同時指定。
401—認証情報が未指定、無効、または期限切れです。
403—現在の認証情報に必要なアクセス権限がありません。
404—フィルター対象の Session がアクセス不可またはアーカイブ済み、その Identity が利用不可、またはカーソルが現在のフィルター範囲外です。
500—サービス内部エラー。
エラーレスポンスの構造は Decision の作成を参照してください。

関連