鉴权与安全
所有开放接口使用 Authorization: Bearer 请求头。密钥只在创建或轮换时显示一次。请使用最小权限、IP 白名单和独立密钥，并验证 Webhook 签名。
服务会返回速率与并发响应头；遇到 429 时遵循 Retry-After。
上传规则
支持 JPEG、PNG、WebP、GIF、BMP 与 PDF，单文件最大 20MB；PDF 最多 10 页。成功任务默认公开脱敏预览与摘要，不公开源文件。
接口与权限
| 方法 | 路径 | 权限 |
|---|---|---|
| GET | /api/open/status | status:read |
| GET | /api/open/quota | quota:read |
| GET | /api/open/tasks | tasks:read |
| POST | /api/open/tasks | tasks:create |
| GET | /api/open/tasks/{task_id} | tasks:read |
| POST | /api/open/tasks/{task_id}/cancel | tasks:create |
| POST | /api/open/batches | batches:create |
| GET | /api/open/batches/{batch_id} | batches:read |
提交示例
curl -X POST "https://YOUR-CAD-DOMAIN/api/open/tasks" \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "profile=standard" \ -F "options_json={}"
profile 可为 standard、full、bom、dimension_tolerance 或 advanced；advanced 通过 options_json.task_list 指定模块。
Webhook
可订阅 task.completed、task.failed、task.cancelled。接收端应使用创建或轮换时显示的密钥验证签名，并按事件 ID 实现幂等。