# 单卡列表（未绑定设备）

## 接口说明
获取**未绑定设备的 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：离线