跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.shannon.run/llms.txt

Use this file to discover all available pages before exploring further.

​
端点

POST http://localhost:8080/api/v1/approvals/decision

​
描述

为等待人工审批的工作流提交“同意/拒绝”决策。成功后，决策会以信号形式发送到工作流，随之继续执行或终止。

​
认证

是否必需：是 请求头： 
X-API-Key: sk_test_123456

​
请求

​
请求头

头部必需说明
X-API-Key是API 认证密钥
Content-Type是application/json
traceparent否W3C Trace 上下文

​
请求体参数

参数类型必需说明
workflow_idstring是目标工作流 ID
approval_idstring是审批标识符
approvedboolean是是否同意
feedbackstring否可选反馈/备注
modified_actionstring否可选的修改后操作
run_idstring否指定运行 ID（可选）
approved_bystring否默认使用已认证用户

​
请求体示例

{
  "workflow_id": "task-123",
  "approval_id": "appr-456",
  "approved": true,
  "feedback": "已审核，允许执行",
  "modified_action": "",
  "run_id": ""
}

​
响应

​
200 OK

{
  "status": "sent",
  "success": true,
  "message": "Approval appr-456 processed successfully",
  "workflow_id": "task-123",
  "run_id": "",
  "approval_id": "appr-456"
}

​
400 / 401 / 403 / 404

{ "error": "..." }

​
示例

​
同意（curl）

curl -X POST "http://localhost:8080/api/v1/approvals/decision" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "task-123",
    "approval_id": "appr-456",
    "approved": true,
    "feedback": "同意执行"
  }'

​
拒绝（Python / httpx）

import httpx

httpx.post(
  "http://localhost:8080/api/v1/approvals/decision",
  headers={"X-API-Key": api_key, "Content-Type": "application/json"},
  json={"workflow_id": wid, "approval_id": appr, "approved": False, "feedback": "风险较高"}
)

​
备注

  • 替代旧版管理端点 http://localhost:8081/approvals/decision（已弃用，建议使用网关端点）。