135 lines
3.2 KiB
Markdown
135 lines
3.2 KiB
Markdown
# 单卡列表（未绑定设备）
|
||
|
||
## 接口说明
|
||
获取**未绑定设备的 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 |
|
||
---
|
||
|
||
## 返回结构
|
||
|
||
```json
|
||
{
|
||
"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已停用 |
|
||
|
||
---
|
||
|
||
## 返回结构
|
||
|
||
```json
|
||
{
|
||
"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：离线 |