# 授权卡列表

## 接口说明
获取**某个企业下的卡列表**，支持分页和简单筛选。

- 请求方式：GET  
- 接口地址：`/api/admin/enterprises/{id}/cards`  
- 认证方式：Bearer Token  

---

## 请求参数

### Path 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | integer | 是 | 企业ID |

---

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| page | integer | 否 | 页码（默认1） |
| page_size | integer | 否 | 每页数量（最大100） |
| status | integer | 否 | 卡状态 |
| carrier_id | integer | 否 | 运营商ID |
| iccid | string | 否 | ICCID（模糊查询） |
| virtual_no | string | 否 | 虚拟号（模糊查询） |

---

## 返回结构

```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	卡号
msisdn	string	手机号
virtual_no	string	虚拟号
carrier_id	integer	运营商ID
carrier_name	string	运营商名称
status	integer	卡状态
status_name	string	状态名称
network_status	integer	网络状态
network_status_name	string	网络状态名称
package_id	integer	套餐ID
package_name	string	套餐名称
device_id	integer	绑定设备ID（可能为空）
常见状态说明
卡状态 status
1：在库
2：已分配
3：已激活
4：已停用

网络状态 network_status
0：停机 / 异常
1：正常

# 授权设备列表

## 接口说明
获取**某个企业下已授权的设备列表**。

- 请求方式：GET  
- 接口地址：`/api/admin/enterprises/{id}/devices`  
- 认证方式：Bearer Token  

---

## 请求参数

### Path 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | integer | 是 | 企业ID |

---

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| page | integer | 否 | 页码 |
| page_size | integer | 否 | 每页数量 |
| virtual_no | string | 否 | 设备虚拟号（模糊查询） |

---

## 返回结构

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [],
    "total": 100
  },
  "timestamp": "2026-03-31T12:00:00Z"
}
```

items 字段说明（企业设备）
字段	类型	说明
device_id	integer	设备ID
device_name	string	设备名称
device_model	string	设备型号
virtual_no	string	设备虚拟号
card_count	integer	已绑定卡数量
authorized_at	string	授权时间