Skip to main content
决策（Beta）

列出 Decisions

分页列出当前认证范围内的判断记录，可按 Session 筛选。

Decision API 目前为 Beta 功能，接口定义、响应结构和行为可能在后续版本中调整。请关注文档更新，并在生产环境使用前完成兼容性验证。
GET /api/v1/forward/decisions

请求头

Header是否必填说明
Authorization是Bearer <PAT 或 SAT>，支持管理员和 Identity 级 SAT。

查询参数

参数类型是否必填默认值说明
session_idstring否—只列出该 Session 的判断记录；Session 必须处于当前认证范围内且未归档。
after_idstring否—向较旧记录翻页，传入上一页的 last_id。
before_idstring否—向较新记录翻页，传入当前页的 first_id。
limitinteger否20每页条数，范围 1～100。
每个参数只能出现一次且不能为空。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。

相关