3.2 KiB
单卡列表（未绑定设备）
接口说明
获取未绑定设备的 IoT 卡列表，支持分页和多条件筛选。
- 请求方式：GET
- 接口地址：
/api/admin/iot-cards/standalone - 认证方式：Bearer Token
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码（默认1） |
| page_size | integer | 否 | 每页数量（最大100） |
| status | integer | 否 | 状态：1在库 / 2已分销 / 3已激活 / 4已停用 |
| carrier_id | integer | 否 | 运营商ID |
返回结构
{
"code": 0,
"msg": "success",
"data": {
"items": [],
"page": 1,
"size": 10,
"total": 100
},
"timestamp": "2026-03-31T12:00:00Z"
}
items 字段说明（卡信息） 字段 类型 说明 id integer 卡ID iccid string 卡号 imsi string IMSI msisdn string 接入号 virtual_no string 虚拟号 status integer 卡状态 activation_status integer 激活状态 network_status integer 网络状态（0停机 / 1开机） real_name_status integer 实名状态（0未实名 / 1已实名） carrier_name string 运营商名称 carrier_type string 运营商类型 supplier string 供应商 batch_no string 批次号 series_name string 套餐系列 shop_name string 分销商 data_usage_mb integer 累计流量 current_month_usage_mb number 本月流量 accumulated_recharge integer 累计充值（分） created_at string 创建时间 updated_at string 更新时间
设备列表
接口说明
获取设备列表，支持分页 + 多条件筛选（名称、状态、厂家等）。
- 请求方式：GET
- 接口地址：
/api/admin/devices - 认证方式：Bearer Token
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码（默认1） |
| page_size | integer | 否 | 每页数量（最大100） |
| virtual_no | string | 否 | 虚拟号（模糊查询） |
| device_name | string | 否 | 设备名称（模糊查询） |
| status | integer | 否 | 状态：1在库 / 2已分销 / 3已激活 / 4已停用 |
返回结构
{
"code": 0,
"msg": "success",
"data": {
"items": [],
"page": 1,
"size": 10,
"total": 100
},
"timestamp": "2026-03-31T12:00:00Z"
}
items 字段说明（设备信息） 字段 类型 说明 id integer 设备ID device_name string 设备名称 device_model string 设备型号 device_type string 设备类型 manufacturer string 制造商 imei string 设备IMEI sn string 序列号 virtual_no string 设备虚拟号 status integer 状态 status_name string 状态名称 online_status integer 在线状态（0未知 / 1在线 / 2离线） bound_card_count integer 已绑定卡数量 max_sim_slots integer 最大插槽数 switch_mode string 切卡模式（0自动 / 1手动） series_name string 套餐系列 shop_name string 所属店铺 software_version string 固件版本 accumulated_recharge integer 累计充值（分） activated_at string 激活时间 last_online_time string 最后在线时间 created_at string 创建时间 updated_at string 更新时间 状态说明 设备状态 status 1：在库 2：已分销 3：已激活 4：已停用 在线状态 online_status 0：未知 1：在线 2：离线