first

docs/资产列表(代理调用的接口).md

@@ -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：离线