API 参考 / admin

把收件转成正式需求 / 缺陷（平台超管）

POST /api/v1/admin/support/intake/{intakeId}/convert · adminConvertSupportIntake

人工确认后建正式单（B-00113 / 决策 D6）：type=bug 建 type=bug 工作项，type=feature 建需求， 落平台客服配置里的支持项目、在其 TenantTx 内写并产 ChangeSet/Event（正常业务写，可追溯）。 落哪个项目由平台配置决定，不从请求体接收 projectId。 并发保护：只有仍处 pending 的条目能被转；已被别人转过或驳回过 → 409，绝不建出重复单。 建单成功但回写收件状态失败时返回 500 并打日志（正式单已建出，需人工核对）。要求平台超管。

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

参数

intakeId（必填）
string

请求体

ownerId
string
note
string

响应字段 · 201

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

错误

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/admin/support/intake/{intakeId}/convert" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"ownerId":"018f3c2e-0000-7000-8000-000000000000","note":"示例文本"}'

响应示例

HTTP/1.1 201
{
  "intake": {
    "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": [
      {
        "id": "018f3c2e-0000-7000-8000-000000000000",
        "fileName": "示例标题",
        "mimeType": "示例文本",
        "size": 1
      }
    ],
    "createdAt": "示例文本"
  },
  "objectId": "018f3c2e-0000-7000-8000-000000000000",
  "displayKey": "示例文本"
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…