批量查询卡板最新状态(10张)

POST

/openapi/iot/batchQuerySimStatus

批量查询卡板最新状态，单次最多10张。

当需要获取最新卡板状态时使用

该接口会同时更新卡板~~已用流量~~、卡板状态、实名/激活状态等基础状态和信息，相同卡板一分钟内调用次数不能超过3次。

注：即使是实时查询，部分上游营运商也可能存在数据延迟

请求参数

Header 参数

appID

string

必需

默认值:

apiVersion

string

必需

默认值:

2.0.0

traceID

string

必需

默认值:

5831f960804c9217ec01e425b8cc76f5

timestamp

string

必需

默认值:

1703592981

sign

string

必需

默认值:

65987d12ae39b2c449b495c77c83c8ef

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

simNos

string

卡板卡号

必需

示例值:

["1920154504"]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:2000/openapi/iot/batchQuerySimStatus' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'simNos=["1920154504"]'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

items

array [object {25}]

必需

isDemote

boolean

必需

是否数据降级。如果我方调用营运商接口超时，则使用我方库中最新数据进行返回

timestamp

integer

必需

traceID

string

必需

示例

成功示例成功示例

{
  "code": 0,
  "message": "操作成功",
  "data": {},
  "timestamp": 1731665696,
  "traceID": "5831f960804c9217ec01e425b8cc76f5"
}

修改于 2025-01-20 02:28:31

批量订阅卡板信息(100张)

批量查询卡板实时流量(10张)