查询单一设备实时信息/Get real-time info about one SIM card

查询某个设备/SIM卡的基本信息、当前正在使用的的套餐信息等。
Query one SIM card real-time information, including the package in use. If the package is not in use，it will not in the response.

请求参数

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

必需

device_id

string

必需

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

timestamp

string

必需

version

string

必需

sign

string

必需

示例

{
  "access_code": "P000270",
  "device_id": "89852022018041800192",
  "timestamp": "1643012271",
  "version": "2.0",
  "sign": "9yYpqL0oLteZCzP8ukVRyl6TE7s="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200Success

application/json

Body

code

string

必需

data

object

必需

sign

string

必需

msisdn

string

必需

device_id

string

必需

ota_flag

string

必需

是否有OTA功能，取值如下： 1-有OTA功能； 2-没有OTA功能；
// OTA support：1-Yes；2-No

bip_flag

string

必需

是否有BIP功能，取值定义如下： 1-有BIP功能； 0-没有BIP功能；
// BIP support：1-Yes；2-No

multiImsi_flag

string

必需

是否是多IMSI设备，取值定义如下： 1-是多IMSI设备； 0-不是多IMSI设备；
// Multi-IMSI support：1-Yes；2-No

lifecycle

string

必需

当前设备所处的生命周期，取值如下。 0-库存期； 1-静默期； 2-使用期； 3-停机保服务期； 4-废弃回收期； 5-内部库存期；
// SIM card lifecycle：1-Pre-activation period； 2-Activation period
； 3-Pre-deactivation period；4-Discard and collect period；5- Internal inventory period ;

lifecycle_start_time

string

必需

当前生命周期起始日期，格式为YYYYMMDD； UTC+8
//The start date of the current life cycle is in the YYYYMMDD format. UTC+8

lifecycle_end_time

string

必需

当前生命周期结束日期，格式为YYYYMMDD； UTC+8
// End date of the current life cycle in the YYYYMMDD format. UTC+8

lifecycle_slient_period

string

必需

静默周期长度,通常为6个月；
// Pre-activation period length, usually 6 months;

lifecycle_shutdown_period

string

必需

停机保服务周期长度，通常为2个月；
// Pre-deactivation period length, usually 2 months;

main_iccid

string

可选

通常为SIM卡的ICCID
// SIM card ICCID

task_no

string

可选

package_order

object

必需

message

string

必需

success

boolean

必需

示例

{
  "code": "0000",
  "data": {
    "sign": "U9Bump7UksOAGGkMXRTf0UlbTeU=",
    "msisdn": "852196310601835",
    "device_id": "89852022018041800192",
    "ota_flag": "1",
    "bip_flag": "",
    "multiImsi_flag": "",
    "lifecycle": "3",
    "lifecycle_start_time": "20210801",
    "lifecycle_end_time": "20210831",
    "lifecycle_slient_period": "6",
    "lifecycle_shutdown_period": "2",
    "main_iccid": null,
    "task_no": null,
    "package_order": {
      "orderCode": null,
      "packageName": null,
      "packageCode": null,
      "packageType": null,
      "buyType": null,
      "orderPeriod": null,
      "flow": "0",
      "usedFlow": "0",
      "flowUseRate": null,
      "orderUsedFlow": "0",
      "orderDate": null,
      "activeDate": null,
      "expireDate": null,
      "isOrderRefuelingPackage": null,
      "refuelingPackageList": []
    }
  },
  "message": "成功",
  "success": true
}