查询单一设备实时信息/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
}