Smarthub Api Cn
  1. SIM卡管理
  • 概述
    • 全局说明
  • SIM卡管理
    • 获取SIM卡详细信息
      GET
    • 批量获取SIM卡详细信息
      GET
    • 获取SIM卡历史变更记录
      GET
    • 获取SIM卡自定义字段
      GET
    • 修改SIM卡自定义字段
      PUT
    • 激活SIM卡
      POST
    • 停用SIM卡
      POST
    • 失效SIM卡
      POST
    • SIM卡订购补充资费方案
      POST
    • 修改SIM卡基础资费方案
      PUT
    • 修改apn状态
      PUT
  • SIM卡批量操作
    • 批量激活SIM卡
      POST
    • 批量停用SIM卡
      POST
    • 批量失效SIM卡
      POST
    • 批量修改SIM卡基础资费方案
      POST
    • 获取批量任务详情
      GET
  • 短信服务
    • 发送下行短信
      POST
    • 查询下行短信发送状态
      GET
    • 上行短信推送
      POST
    • MT短信状态报告推送
      POST
  • 订阅通知
    • 通知用户其SIM卡周期用量已到达设置的告警阈值
      POST
    • 通知用户其SIM卡关联终端IMEI已变更
      POST
    • 通知用户其SIM卡已长时间无网络连接
      POST
    • 通知用户其SIM卡订购的预付资费方案即将到期
      POST
    • 通知用户其SIM卡订购的预付流量使用已到达设置的告警阈值
      POST
    • 通知用户其SIM卡状态已经改变
      POST
    • 通知用户其SIM卡的APN状态已经改变
      POST
  • 共享流量池
    • 获取流量池信息
  • 企业信息
    • 获取企业信息
    • 获取帐户信息
    • 获取资费方案信息
  • Sim卡统计
    • 获取SIM卡统计的国家码的流量和卡数
  1. SIM卡管理

批量获取SIM卡详细信息

GET
/global-sims
获取SIM卡详细信息,包含首次激活时间,周期用量及资费方案用量等。
以下是 SIM 卡返回的状态说明:
status描述
TEST_READY可测试,表示 SIM 卡的初始状态
ACTIVATE_READY可激活,表示 SIM 卡的测试用量刚好用完时的状态
INVENTORY库存,表示 SIM 卡处于库存中
ACTIVATED已激活,表示 SIM 卡处于正常使用时的状态
DEACTIVATED已停用,表示 SIM 卡处于不可使用时的状态
RETIRED已失效,表示 SIM 卡处于不可使用时的状态,不可再激活

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/global-sims?status&po=8723164786&customerName=example_customer&accountName=example_account&basicServicePackageName&giccids=giccid01,giccid02&page&size=10' \
--header 'X-API-Key;'

返回响应

🟢200成功
application/json
SIM卡信息列表查询
Body

示例
{
    "data": [
        {
            "giccid": "8986011805021000040",
            "deviceInfo": [
                {
                    "imei": "460013050000000",
                    "imsi": "460013050000000",
                    "msisdn": "8613856541093"
                }
            ],
            "status": "TEST_READY",
            "sellTime": "2018-10-10T10:32:50+0000",
            "activatedTime": "2018-10-10T10:32:50+0000",
            "currentCycleUsages": {
                "dataUsage": 23.323,
                "smsUsage": 30,
                "voiceUsage": 10
            },
            "currentCycleAPNUsagesList": [
                {
                    "apn": "apn1",
                    "dataUsage": 23.323
                }
            ],
            "currentBasicServicePackage": {
                "name": "Prepaid-Basic-10M",
                "startTime": "2018-10-10T10:32:50+0000",
                "endTime": "2018-10-10T10:32:50+0000"
            },
            "apnList": [
                {
                    "apnName": "apn1",
                    "apnStatus": "CLOSED"
                },
                {
                    "apnName": "apn2",
                    "apnStatus": "OPEN"
                }
            ]
        }
    ],
    "page": 0,
    "size": 10,
    "total": 100
}
修改于 2025-06-27 03:30:48
上一页
获取SIM卡详细信息
下一页
获取SIM卡历史变更记录
Built with