Skip to main content
决策（Beta）

获取 Decision

根据 ID 查询一次判断的状态、答案和上下文摘要。

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

请求头

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

路径参数

参数类型是否必填说明
decision_idstring是创建接口返回的 Decision ID，1～256 字节，无首尾空白、控制字符及 /、\、?、#。
本接口不接受查询参数。记录必须在当前认证范围内。

示例请求

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。

相关