外部工单 API
通过两个接口接入 SuperTop Ads：提交需求，查询工单状态。
API 地址：https://api.supertopads.com
| 方法 | 路径 | 用途 |
|---|---|---|
POST |
/v1/orders |
提交需求，返回内部工单 ID |
GET |
/v1/orders/status |
按内部工单 ID 或外部请求 ID 查询状态 |
仅允许下列出口公网 IP访问 API：
47.86.53.16443.98.168.255
使用 HTTPS。请求通过 Cloudflare WAF 和来源 IP 校验；本阶段无需额外 API Key。文档站可以公开浏览，不代表 API 对所有 IP 开放。
- 为每个需求生成唯一的
account_demand_id。 - 使用 IANA 时区与 ISO 4217 币种，按提交工单格式发送 JSON。
- 收到 HTTP
202后保存返回的order_id。 - 通过查询状态获取当前状态。
- 超时或网络中断时，使用相同请求 ID、相同内容重试。
account_demand_id 是你方请求 ID，order_id 是我方生成的工单 ID。二者保持一一对应。
需要绑定或解绑外部 BM 时，请查看 BM 绑定与解绑工单。