拉取状态报告

POST

/sendsms/report/pull

状态报告主动拉取。HTTP 状态码恒为 200，业务结果通过 code 区分。

限频：默认 5 秒 1 次（apiLimiter.defaultTime / defaultCount）

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "count": 100
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl -X POST 'http://localhost:8080/sendsms/report/pull' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: <your-api-key>' \
  -H 'X-Timestamp: <unix-timestamp>' \
  -H 'X-Nonce: <random-string>' \
  -H 'X-Sign: <sha256-hex>' \
  -d '{"count": 100}'

返回响应

🟢200

application/json

HTTP 状态码恒为 200，业务结果通过 code 区分

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "OK",
    "data": [
        {
            "time": 1735718400,
            "batch_id": "951753963258741236",
            "status": "DELIVRD",
            "status_desc": "接收成功",
            "phone_data": "自定义透传参数",
            "phone_number": "13800138000",
            "user_data": "自定义用户数据",
            "split_count": 1
        }
    ]
}

上行短信推送

拉取上行短信