V2.0开放接口
  1. 物联卡业务
V2.0开放接口
  • 对接前必看
  • 号卡/宽带业务
    • 号卡订单状态码说明
    • 关于下单省市区编码
    • 获取店铺基础配置
      GET
    • 获取在售商品列表
      POST
    • 发送短信验证码
      POST
    • 预选下单号码
      POST
    • 提交申请订单
      POST
    • 订单查询
      POST
    • 获取指定商品详细信息
      POST
    • 上传证件照
      POST
    • 订单回调
      POST
    • IP定位
      GET
  • 靓号业务
    • 获取靓号列表
  • 物联卡业务
    • 物联卡相关状态码说明
    • 批量查询卡板信息(100张)
      POST
    • 批量订阅卡板信息(100张)
      POST
    • 批量查询卡板最新状态(10张)
      POST
    • 批量查询卡板实时流量(10张)
      POST
    • 批量查询卡板指定月流量(10张)
      POST
    • 批量停机(100张)
      POST
    • 批量复机(100张)
      POST
    • 单卡机卡绑定
      POST
    • 单卡限速
      POST
    • 单卡解除限速
      POST
    • 单卡/设备订购套餐包
      POST
    • 获取官方实名链接
      POST
    • 查询卡板操作记录
      POST
    • 查询账户资产
      POST
    • 获取移动流量池Token
      POST
    • 查询设备信息
      POST
    • 查询设备流量
      POST
    • 设备切换网络
      POST
  1. 物联卡业务

查询卡板操作记录

POST
/openapi/iot/querySimAction
查询卡板操作记录,支持流水号或卡板卡号查询,也可以组合使用。
主要用于批量停机、复机等操作中查询我方是否已正式向营运商递交申请。状态为失败的则必然失败,为成功的只代表递交申请成功,不代表一定办理成功。因部分营运商不会返回最终执行结果,故还要以实际结果为准。
若返回数据中没有对接方提交的批量停机、复机等操作数据,则说明我方还未向营运商递交申请,一般会在对接方提交操作后的1-3分钟内进行,对接方可多次查询操作结果。

请求参数

Header 参数
appID
string 
必需
默认值:
1
apiVersion
string 
必需
默认值:
2.0.0
traceID
string 
必需
默认值:
5831f960804c9217ec01e425b8cc76f5
timestamp
string 
必需
默认值:
1703592981
sign
string 
必需
默认值:
65987d12ae39b2c449b495c77c83c8ef
Body 参数application/x-www-form-urlencoded
serialNumber
string 
可选
流水号,批量停机、复机接口返回的流水号。可查询流水号下所有的卡板操作记录
示例值:
91178731657918899855270189630549
simNo
string 
可选
卡板卡号,只通过卡号查询时会返回最近100条全部类型的操作记录
示例值:
164009797BB
actionType
string 
可选
操作类型,可配合卡板卡号使用来查询单卡最近100条某个类型的操作记录
示例值:
3

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1:2000/openapi/iot/querySimAction' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'serialNumber=91178731657918899855270189630549'

返回响应

🟢200成功
application/json
Body
0成功,其他失败
code
integer 
必需
message
string 
必需
data
object 
数据集
必需
items
array [object {8}] 
数据集
必需
timestamp
integer 
必需
traceID
string 
必需
示例
{
  "code": 0,
  "message": "操作成功",
  "data": {
    "items": [
      {
        "actionType": 3,
        "actionTypeText": "复机",
        "operateId": 8066,
        "simNo": "164009797BB",
        "status": 2,
        "failReason": "渠道内部请求超时或出错,请稍候重试",
        "serialNumber": "02777884406535155964470089152580",
        "createdAt": "2024-11-25 10:16:22"
      },
      {
        "actionType": 3,
        "actionTypeText": "复机",
        "operateId": 8066,
        "simNo": "164009797BB",
        "status": 1,
        "failReason": "",
        "serialNumber": "12716229997434306483481259381985",
        "createdAt": "2024-11-25 10:49:46"
      }
    ]
  },
  "timestamp": 1732505734,
  "traceID": "5831f960804c9217ec01e425b8cc76f5"
}
上一页
获取官方实名链接
下一页
查询账户资产
Built with