API 参考
WorkItem 操作、决策步骤控制、集成执行和遥测导出的参考。
这些 API 专为具有明确策略和租户范围的可预测自动化行为而设计。
基本端点
使用您配置的公共 API 端点来进行经过身份验证的请求。
https://api.threada.ai身份验证和上下文
- 使用限定范围的凭据进行 API 访问
- 根据需要包括租户和角色上下文
- 没有有效上下文的请求无法关闭
典型范围
- workitems:read 和 workitems:write
- workflow:manage 用于政策和决策更新
- actions:execute 用于受控执行
- telemetry:read 用于导出和分析
分页和过滤
- 列表端点支持基于光标或基于令牌的分页
- 按渠道、工作流程、状态、策略版本和时间范围过滤
- 首选有界窗口进行大型遥测导出
误差模型
- 验证、授权、策略和执行失败的键入错误类别
- 原因代码支持操作员工具中的确定性处理
- 返回相关 ID 以进行跨服务调查
请求示例
从接收有效负载创建一个工作项
创建用于工作流程处理的规范工作记录。需要时包括进气通道的通道标识符。
要求
curl -X POST "https://api.threada.ai/work-items" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d "{\"workflow_id\":\"policy_review\",\"channel_id\":\"web_main\",\"payload\":{\"message\":\"Review this renewal request before approval\"}}" 回复
{
"work_item_id": "wi_123",
"status": "new",
"workflow_id": "policy_review"
}执行批准的行动
针对配置的集成运行策略批准的操作。
要求
curl -X POST "https://api.threada.ai/actions/execute" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d "{\"work_item_id\":\"wi_123\",\"action_id\":\"request_approval\",\"integration_id\":\"int_workflow\"}" 回复
{
"execution_id": "ex_456",
"status": "started",
"idempotency_key": "idem_789"
}