把数字员工能力
接入你的业务系统

通过统一 REST API 提交任务、查询执行状态与数字员工档案。接口使用 X-API-Key 鉴权，所有请求记录调用来源与响应耗时，便于审计与排障。

30 数字员工160 累计任务REST JSON99.95% 可用性

鉴权方式

除健康检查外，所有接口均需在请求头携带 API Key。密钥由超级管理员在管理后台「接口与外部系统对接」中统一分配，请勿在前端代码中暴露。

请求头X-API-Key: <your_api_key> Content-Type: application/json

curl -X GET "https://api.szdd.autoambe.com/v1/agents?status=在线" \
  -H "X-API-Key: YOUR_API_KEY"

Base URL：https://api.szdd.autoambe.com

方法	路径	说明
GET	/v1/health	健康检查，无需鉴权，返回服务与数据库状态
GET	/v1/overview	调度总览指标：数字员工、任务、告警与 SLA 概览
GET	/v1/agents	数字员工列表，支持 status / dept / page / page_size
GET	/v1/agents/{id}	数字员工详情，含技能矩阵与最新绩效
GET	/v1/tasks	任务列表，支持 status / priority / q / page
GET	/v1/tasks/{id}	任务详情，含执行轨迹
POST	/v1/tasks	创建任务，自动进入智能调度队列
GET	/v1/policies	查询已发布的调度策略
GET	/v1/alerts	查询异常告警，支持 level / status

POST /v1/tasks

{
  "title": "华南区客户投诉工单处理",
  "type": "客户服务",
  "priority": "高",
  "requester": "张伟",
  "dept": "客户服务中心",
  "description": "请核查投诉原因并回访客户"
}

统一 JSON Envelope

{
  "code": 0,
  "message": "ok",
  "data": { ... },
  "timestamp": "2026-10-29T10:30:00+08:00"
}

code = 0 表示成功；401 鉴权失败；422 参数校验失败；500 服务异常。

幂等与重试
建议业务侧为每次创建任务生成唯一业务流水号，失败重试时携带相同标题与发起人，便于调度侧去重。

异步执行
任务创建后立即返回任务编号，执行过程通过 /v1/tasks/{id} 轮询，或在管理后台「接口配置」中启用回调地址。

错误处理
遵循 HTTP 状态码与 code 字段；401 请检查密钥，422 请根据 message 修正字段后重试。

安全合规
API Key 按环境隔离，禁止写入前端或公开仓库；敏感字段传输需使用 HTTPS，并遵循企业数据分级要求。