DEVELOPER API

将任务能力接入你的系统

每个用户可以在用户中心独立启用 API、创建 Token、限制调用 IP 和查看调用记录。API 提交的任务会同步显示在任务中心。

开始接入

登录用户中心，进入“API 接入”页面。
启用 API 功能并创建一个 Token。
妥善保存仅显示一次的完整 Token。
在请求头中发送 X-API-Key。

Token 仅在创建时显示一次；忘记后请撤销旧 Token 并创建新的。

身份验证

X-API-Key: up_live_your_token

也支持标准 Bearer 形式：

Authorization: Bearer up_live_your_token

提交批量任务

POST/api/v1/open/batches

curl -X POST "https://你的域名/api/v1/open/batches" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: up_live_your_token" \
  -d '{
    "lines": [
      "account@example.com----password----recovery@example.com"
    ],
    "ownership_confirmed": true
  }'

成功响应

{
  "request_id": "R-XXXXXXXXXXXX",
  "batch_id": 120,
  "created": [{"job_id":"J-...","status":"QUEUED"}],
  "rejected": []
}

查询最近任务

GET/api/v1/open/jobs?limit=50

curl "https://你的域名/api/v1/open/jobs?limit=50" \
  -H "X-API-Key: up_live_your_token"

查询单个任务

GET/api/v1/open/jobs/{job_id}

常见错误码

401Token 缺失、无效或已过期

403API 未启用、管理员锁定或 IP 不在白名单

409资源状态冲突

422请求格式或任务内容校验失败

429超过 Token 的每分钟调用上限