查询任务与反馈
查询接口使用相同的 OpenAPI 签名鉴权,只能访问凭据所属客户的数据。
主要查询接口
| 方法与路径 | 用途 |
|---|---|
| GET /openapi/v1/messages/tasks/ | 任务列表,可按 client_request_id 关联业务 |
| GET /openapi/v1/messages/tasks/{task_no}/ | 任务详情 |
| GET /openapi/v1/messages/receipts/ | 号码回执 |
| GET /openapi/v1/messages/uplinks/ | 上行消息 |
| GET /openapi/v1/finance/ledgers/ | 财务流水 |
| GET /openapi/v1/downstream/submits/ | 下游提交记录 |
| GET /openapi/v1/downstream/deliveries/ | 下游投递记录 |
分页与时间范围
常规分页参数为 page 与 page_size,默认 page_size=20,最大 100。支持时间筛选的查询使用 start_at/end_at。不同资源的其他筛选字段请在联调时按当前 schema 核对。
分别理解各阶段状态
queued/prepared/submitting 表示编排或提交阶段;waiting_receipt 表示等待回执;submit_unknown 表示上游受理待核实。账务状态和回执结果要分别查看,不由 HTTP 200 推断送达或扣费。
金额与对账
金额以接口返回的十进制字符串处理,避免浮点误差。按照客户的计费模式、实际流水和最终业务状态核对冻结、扣费、释放和退款。