This commit is contained in:
sexygoat
2026-03-31 18:41:52 +08:00
commit 3c62cc1cd1
527 changed files with 96725 additions and 0 deletions

View File

@@ -0,0 +1,135 @@
# 单卡列表(未绑定设备)
## 接口说明
获取**未绑定设备的 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:离线