AI AI Skills 开放平台

HTTP 请求、上传、幂等与任务轮询

report-generation HTTP-REQUESTS.md

HTTP 请求、上传、幂等与任务轮询

令 BASE=${AI_SKILLS_API_URL:-https://ai-skills.open-idea.net/api/v1}。每个新业务动作生成 UUID Idempotency-Key；所有请求携带 Authorization: Bearer ${REPORT_GENERATION_API_KEY:-$AI_SKILLS_API_KEY}。文件入口使用 multipart/form-data，其他入口使用 Content-Type: application/json。

  • POST /api/v1/report-generation/report.inspect；GET /api/v1/report-generation/report.inspect/tasks/{task_id}
  • POST /api/v1/report-generation/report.generate；GET /api/v1/report-generation/report.generate/tasks/{task_id}
  • POST /api/v1/report-generation/report.export；GET /api/v1/report-generation/report.export/tasks/{task_id}
curl -sS -X POST "$BASE/report-generation/report.inspect" \
  -H "Authorization: Bearer ${REPORT_GENERATION_API_KEY:-$AI_SKILLS_API_KEY}" \
  -H "Idempotency-Key: $REQUEST_UUID" -F "file=@operations.csv"

200 表示完成，202 表示已接收。收到 202 后有限退避轮询对应 /tasks/{task_id}，读取 succeeded、partial、failed 与 artifacts。优先读取 errors.code，兼容 error.code。结果不确定时只重放相同输入和原键。