查询卡板短信记录

POST

/openapi/iot/simSmsQuery

查询当前账号名下某张卡的短信记录，数据来自我方本地记录。

fromDate、toDate 都不传时，默认查最近 7 天。只传其中一个会返回「请同时传入开始和结束时间」。

时间跨度不能超过 31 天。开始时间不能晚于结束时间。

单次最多返回 2000 条，按记录 ID 倒序。本接口没有短信回调。

请求参数

Header 参数

Body 参数application/x-www-form-urlencoded

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://192.168.1.88:2000/openapi/iot/simSmsQuery' \
--header 'appID: 1' \
--header 'appID: 1' \
--header 'apiVersion: 2.0.0' \
--header 'apiVersion: 2.0.0' \
--header 'traceID: 5831f960804c9217ec01e425b8cc76f5' \
--header 'traceID: 5831f960804c9217ec01e425b8cc76f5' \
--header 'timestamp: 1775742706' \
--header 'timestamp: 1775742706' \
--header 'sign: ee0c7fd88f098cb4cf4c4eed5aa66bc3' \
--header 'sign: ee0c7fd88f098cb4cf4c4eed5aa66bc3' \
--data-urlencode 'simNo=19287697291' \
--data-urlencode 'fromDate=2024-11-07 00:00:00' \
--data-urlencode 'toDate=2024-11-14 23:59:59'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "list": [
            {
                "direction": 1,
                "sendStatus": 1,
                "smsType": 1,
                "encoding": "default",
                "content": "测试短信",
                "smsMsgId": "SMS202411140001",
                "failReason": "",
                "sentAt": "2024-11-14 12:00:00",
                "receiveAt": ""
            }
        ]
    },
    "timestamp": 1731665385,
    "traceID": "5831f960804c9217ec01e425b8cc76f5"
}

发送卡板短信

查询卡板操作记录