批量查询SIM卡流量接口 /Batch querying SIM card usage

Cube UAT

POST

/device/queryBatchDeviceByAssetIds

批量查询若干个SIM卡的当前周期已用流量
// Batch querying the uasge of several SIM cards in the current period.

请求参数

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

access_code

string

必需

asset_ids

array[string]

必需

设备标识，通常为SIM卡ICCID.
// SIM card ICCID.

sign

string

必需

timestamp

string

必需

version

string

必需

示例

{
  "access_code": "P000270",
  "asset_ids": [
    "89314404000901473406"
  ],
  "sign": "NWxBpEgd7Y9WnOYBDOBYIFris50=",
  "timestamp": "1493893333",
  "version": "2.0"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-uat.io.linksfield.net/cube/v4/device/queryBatchDeviceByAssetIds' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_code": "P000270",
    "asset_ids": [
        "89314404000901473406"
    ],
    "sign": "NWxBpEgd7Y9WnOYBDOBYIFris50=",
    "timestamp": "1493893333",
    "version": "2.0"
}'

返回响应

🟢200Success

application/json

Body

code

string

必需

data

array [object {5}]

必需

iccid

string

可选

设备标识，领科系统内对SIM卡的唯一标识.
// SIM card ICCID.

flow

string

可选

本周期使用流量，单位kb.
// current cycle usage, kb

status

string

可选

卡片生命周期状态，1：静默期；2：使用期；3：停机保服务期；4：废弃回收期；
// SIM card lifecycle：1-Pre-activation period； 2-Activation period
； 3-Pre-deactivation period；4-Discard and collect period

conform

boolean

可选

卡片是否合法
// Whether the card exists.

msg

string

可选

异常信息
// description

message

string

必需

success

boolean

必需

示例

{
  "code": "0000",
  "data": [
    {
      "iccid": "89852022018041800192",
      "flow": "0",
      "status": "3",
      "conform": true,
      "msg": null
    }
  ],
  "message": "成功",
  "success": true
}

修改于 2022-12-12 03:21:14

查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card

查询单日流量使用情况 / Example Query the daily usage