API / QUERIES

查询任务与反馈

查询接口使用相同的 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 推断送达或扣费。

金额与对账

金额以接口返回的十进制字符串处理,避免浮点误差。按照客户的计费模式、实际流水和最终业务状态核对冻结、扣费、释放和退款。

继续了解

LET’S GET STARTED

下一次营销触达,从一个好方案开始。

告诉我们您的业务场景,一起选择合适的消息样式、接入方式与投放流程。

获取投放方案