API 参考 / admin

列客服气泡收件箱（平台超管）

GET /api/v1/admin/support/intake · adminListSupportIntake

运营审核列表（B-00113 / 决策 D6）：公开提交只落收件箱、不创建业务对象，这里是人工审核入口。 status 省略 = 全部；非法 status 直接 422（不静默扩大成全集）。按提交时间倒序。要求平台超管。

按收件编号查（B-00258）：带 id 时精确匹配该编号，返回 0 或 1 条，忽略 status / limit。 提交者拿到的 36 位收件编号只能在这里查——不开公开查询端点，避免多一个匿名可打的面。 编号不存在时返回空列表（200），不返回 404：对超管而言「查无此单」是正常结果，不是错误。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

status
string
limit
integer
id
string —— 收件编号精确匹配（提交者手里的那串编号）。给了它就忽略 status 与 limit。

响应字段 · 200

items（必填）
SupportIntakeTicket[]
items[].id（必填）
string
items[].type（必填）
enum；取值：bug / feature
items[].status（必填）
enum；取值：pending / converted / rejected
items[].title（必填）
string
items[].description（必填）
string
items[].module（必填）
string
items[].severity（必填）
string
items[].role（必填）
string
items[].contact（必填）
string —— 匿名提交者自填的联络邮箱；已登录提交恒为空
items[].submitterUserId（必填）
string —— 服务端从已验证会话解析的 canonical userId；匿名提交为空
items[].submitterEmail（必填）
string —— 服务端从会话解析出的登录邮箱；匿名提交为空
items[].source（必填）
enum —— 仅作渠道标签；历史记录归一为 human；取值：human / agent
items[].sourceMetadata（必填）
SupportSourceMetadata
items[].sourceMetadata.pluginVersion
string
items[].sourceMetadata.hostType
enum；取值：codex / claude_code
items[].sourceMetadata.hostVersion
string
items[].sourceMetadata.operationId
string
items[].sourceMetadata.traceId
string
items[].sourceMetadata.reproduction
string
items[].attachments（必填）
SupportIntakeAttachmentNote[]
items[].attachments[].id（必填）
string
items[].attachments[].fileName（必填）
string
items[].attachments[].mimeType（必填）
string
items[].attachments[].size（必填）
integer
items[].convertedProjectId
string
items[].convertedObjectId
string
items[].convertedDisplayKey
string
items[].reviewedBy
string
items[].reviewedAt
string
items[].reviewNote
string
items[].createdAt（必填）
string

错误

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/support/intake?status=…&limit=…" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "type": "bug",
      "status": "pending",
      "title": "示例标题",
      "description": "一段描述文字",
      "module": "示例文本",
      "severity": "示例文本",
      "role": "示例文本",
      "contact": "示例文本",
      "submitterUserId": "018f3c2e-0000-7000-8000-000000000000",
      "submitterEmail": "[email protected]",
      "source": "human",
      "sourceMetadata": {
        "pluginVersion": "示例文本",
        "hostType": "codex",
        "hostVersion": "示例文本"
      },
      "attachments": [
        {}
      ],
      "createdAt": "示例文本"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…