docs: 重新生成 OpenAPI 文档，补全 Phase 03.1 新增字段
This commit is contained in:
@@ -581,27 +581,111 @@ components:
|
|||||||
type: object
|
type: object
|
||||||
DtoAssetInfoResponse:
|
DtoAssetInfoResponse:
|
||||||
properties:
|
properties:
|
||||||
|
activated_at:
|
||||||
|
description: 激活时间
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
activation_status:
|
||||||
|
description: 激活状态（0:未激活, 1:已激活）
|
||||||
|
type: integer
|
||||||
asset_id:
|
asset_id:
|
||||||
description: 资产ID
|
description: 资产ID
|
||||||
minimum: 0
|
minimum: 0
|
||||||
type: integer
|
type: integer
|
||||||
asset_type:
|
asset_type:
|
||||||
description: 资产类型 (card:卡, device:设备)
|
description: 资产类型（card:卡, device:设备）
|
||||||
type: string
|
type: string
|
||||||
|
bound_card_count:
|
||||||
|
description: 绑定卡数量
|
||||||
|
type: integer
|
||||||
|
bound_device_id:
|
||||||
|
description: 绑定的设备ID
|
||||||
|
minimum: 0
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
bound_device_name:
|
||||||
|
description: 绑定的设备名称
|
||||||
|
type: string
|
||||||
|
bound_device_no:
|
||||||
|
description: 绑定的设备虚拟号
|
||||||
|
type: string
|
||||||
|
card_category:
|
||||||
|
description: 卡业务类型（normal:普通卡, industry:行业卡）
|
||||||
|
type: string
|
||||||
|
cards:
|
||||||
|
description: 绑定卡列表（含每张卡的ICCID/MSISDN/网络状态/实名状态/插槽位置）
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/DtoBoundCardInfo'
|
||||||
|
type: array
|
||||||
|
carrier_id:
|
||||||
|
description: 运营商ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
carrier_name:
|
carrier_name:
|
||||||
description: 运营商名称
|
description: 运营商名称
|
||||||
type: string
|
type: string
|
||||||
|
carrier_type:
|
||||||
|
description: 运营商类型（CMCC/CUCC/CTCC/CBN）
|
||||||
|
type: string
|
||||||
|
current_package:
|
||||||
|
description: 当前套餐名称（无套餐时为空）
|
||||||
|
type: string
|
||||||
|
device_model:
|
||||||
|
description: 设备型号
|
||||||
|
type: string
|
||||||
|
device_name:
|
||||||
|
description: 设备名称
|
||||||
|
type: string
|
||||||
|
device_protect_status:
|
||||||
|
description: 设备保护期状态（none:无, stop:停机保护, start:开机保护）
|
||||||
|
type: string
|
||||||
|
device_realtime:
|
||||||
|
$ref: '#/components/schemas/DtoDeviceRealtimeInfo'
|
||||||
|
device_type:
|
||||||
|
description: 设备类型
|
||||||
|
type: string
|
||||||
generation:
|
generation:
|
||||||
description: 制式
|
description: 世代
|
||||||
|
type: string
|
||||||
|
iccid:
|
||||||
|
description: 卡ICCID
|
||||||
type: string
|
type: string
|
||||||
identifier:
|
identifier:
|
||||||
description: 资产标识符
|
description: 资产标识符
|
||||||
type: string
|
type: string
|
||||||
real_name_status:
|
imei:
|
||||||
description: 实名状态 (0:未实名, 1:已实名)
|
description: 设备IMEI
|
||||||
|
type: string
|
||||||
|
manufacturer:
|
||||||
|
description: 制造商
|
||||||
|
type: string
|
||||||
|
max_sim_slots:
|
||||||
|
description: 最大插槽数
|
||||||
type: integer
|
type: integer
|
||||||
|
msisdn:
|
||||||
|
description: 手机号
|
||||||
|
type: string
|
||||||
|
network_status:
|
||||||
|
description: 网络状态（0:停机, 1:开机）
|
||||||
|
type: integer
|
||||||
|
package_remain_mb:
|
||||||
|
description: 当前剩余虚流量(MB)，已按虚流量比例换算
|
||||||
|
type: number
|
||||||
|
package_total_mb:
|
||||||
|
description: 当前套餐总虚流量(MB)，已按虚流量比例换算
|
||||||
|
type: integer
|
||||||
|
package_used_mb:
|
||||||
|
description: 当前已用虚流量(MB)，已按虚流量比例换算
|
||||||
|
type: number
|
||||||
|
real_name_status:
|
||||||
|
description: 实名状态（0:未实名, 1:已实名）
|
||||||
|
type: integer
|
||||||
|
sn:
|
||||||
|
description: 设备序列号
|
||||||
|
type: string
|
||||||
status:
|
status:
|
||||||
description: 状态 (0:禁用, 1:启用)
|
description: 状态（1:在库, 2:已分销, 3:已激活, 4:已停用）
|
||||||
type: integer
|
type: integer
|
||||||
virtual_no:
|
virtual_no:
|
||||||
description: 虚拟号
|
description: 虚拟号
|
||||||
@@ -703,6 +787,24 @@ components:
|
|||||||
description: 已用虚流量(MB)，按virtual_ratio换算
|
description: 已用虚流量(MB)，按virtual_ratio换算
|
||||||
type: number
|
type: number
|
||||||
type: object
|
type: object
|
||||||
|
DtoAssetPackagesResult:
|
||||||
|
properties:
|
||||||
|
items:
|
||||||
|
description: 套餐列表
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/DtoAssetPackageResponse'
|
||||||
|
nullable: true
|
||||||
|
type: array
|
||||||
|
page:
|
||||||
|
description: 当前页码
|
||||||
|
type: integer
|
||||||
|
page_size:
|
||||||
|
description: 每页条数
|
||||||
|
type: integer
|
||||||
|
total:
|
||||||
|
description: 总条数
|
||||||
|
type: integer
|
||||||
|
type: object
|
||||||
DtoAssetRealtimeStatusResponse:
|
DtoAssetRealtimeStatusResponse:
|
||||||
properties:
|
properties:
|
||||||
asset_id:
|
asset_id:
|
||||||
@@ -723,6 +825,8 @@ components:
|
|||||||
device_protect_status:
|
device_protect_status:
|
||||||
description: 保护期状态（asset_type=device时有效）：none/stop/start
|
description: 保护期状态（asset_type=device时有效）：none/stop/start
|
||||||
type: string
|
type: string
|
||||||
|
device_realtime:
|
||||||
|
$ref: '#/components/schemas/DtoDeviceGatewayInfo'
|
||||||
last_sync_time:
|
last_sync_time:
|
||||||
description: 最后同步时间（asset_type=card时有效）
|
description: 最后同步时间（asset_type=card时有效）
|
||||||
format: date-time
|
format: date-time
|
||||||
@@ -732,7 +836,7 @@ components:
|
|||||||
description: 网络状态（asset_type=card时有效）：0停机 1开机
|
description: 网络状态（asset_type=card时有效）：0停机 1开机
|
||||||
type: integer
|
type: integer
|
||||||
real_name_status:
|
real_name_status:
|
||||||
description: 实名状态（asset_type=card时有效）
|
description: 实名状态（asset_type=card时有效）：0未实名 1已实名
|
||||||
type: integer
|
type: integer
|
||||||
type: object
|
type: object
|
||||||
DtoAssetRefreshRequest:
|
DtoAssetRefreshRequest:
|
||||||
@@ -846,6 +950,16 @@ components:
|
|||||||
imsi:
|
imsi:
|
||||||
description: IMSI
|
description: IMSI
|
||||||
type: string
|
type: string
|
||||||
|
last_gateway_sync_at:
|
||||||
|
description: 最后 sync-info 同步时间（设备类型时有效）
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_online_time:
|
||||||
|
description: 最后在线时间（设备类型时有效）
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
manufacturer:
|
manufacturer:
|
||||||
description: 制造商
|
description: 制造商
|
||||||
type: string
|
type: string
|
||||||
@@ -858,6 +972,9 @@ components:
|
|||||||
network_status:
|
network_status:
|
||||||
description: 网络状态：0停机 1开机（asset_type=card时有效）
|
description: 网络状态：0停机 1开机（asset_type=card时有效）
|
||||||
type: integer
|
type: integer
|
||||||
|
online_status:
|
||||||
|
description: 在线状态：0未知 1在线 2离线（设备类型时有效）
|
||||||
|
type: integer
|
||||||
package_remain_mb:
|
package_remain_mb:
|
||||||
description: 当前套餐剩余虚流量(MB)，已按virtual_ratio换算
|
description: 当前套餐剩余虚流量(MB)，已按virtual_ratio换算
|
||||||
type: number
|
type: number
|
||||||
@@ -868,7 +985,7 @@ components:
|
|||||||
description: 当前已用虚流量(MB)，已按virtual_ratio换算
|
description: 当前已用虚流量(MB)，已按virtual_ratio换算
|
||||||
type: number
|
type: number
|
||||||
real_name_status:
|
real_name_status:
|
||||||
description: 实名状态：0未实名 1实名中 2已实名
|
description: 实名状态：0未实名 1已实名
|
||||||
type: integer
|
type: integer
|
||||||
series_id:
|
series_id:
|
||||||
description: 套餐系列ID
|
description: 套餐系列ID
|
||||||
@@ -889,12 +1006,18 @@ components:
|
|||||||
sn:
|
sn:
|
||||||
description: 设备序列号
|
description: 设备序列号
|
||||||
type: string
|
type: string
|
||||||
|
software_version:
|
||||||
|
description: 固件版本号（设备类型时有效）
|
||||||
|
type: string
|
||||||
status:
|
status:
|
||||||
description: 资产状态
|
description: 资产状态
|
||||||
type: integer
|
type: integer
|
||||||
supplier:
|
supplier:
|
||||||
description: 供应商
|
description: 供应商
|
||||||
type: string
|
type: string
|
||||||
|
switch_mode:
|
||||||
|
description: 切卡模式：0=自动，1=手动（设备类型时有效）
|
||||||
|
type: string
|
||||||
updated_at:
|
updated_at:
|
||||||
description: 更新时间
|
description: 更新时间
|
||||||
format: date-time
|
format: date-time
|
||||||
@@ -1229,9 +1352,6 @@ components:
|
|||||||
type: string
|
type: string
|
||||||
price_adjustment:
|
price_adjustment:
|
||||||
$ref: '#/components/schemas/DtoPriceAdjustment'
|
$ref: '#/components/schemas/DtoPriceAdjustment'
|
||||||
pricing_target:
|
|
||||||
description: 调价目标 cost_price-成本价(默认) retail_price-零售价
|
|
||||||
type: string
|
|
||||||
series_id:
|
series_id:
|
||||||
description: 套餐系列ID（可选，不填则调整所有）
|
description: 套餐系列ID（可选，不填则调整所有）
|
||||||
minimum: 0
|
minimum: 0
|
||||||
@@ -1322,6 +1442,9 @@ components:
|
|||||||
iccid:
|
iccid:
|
||||||
description: ICCID
|
description: ICCID
|
||||||
type: string
|
type: string
|
||||||
|
is_current:
|
||||||
|
description: 是否为当前使用的卡
|
||||||
|
type: boolean
|
||||||
msisdn:
|
msisdn:
|
||||||
description: 手机号
|
description: 手机号
|
||||||
type: string
|
type: string
|
||||||
@@ -1329,7 +1452,7 @@ components:
|
|||||||
description: 网络状态：0停机 1开机
|
description: 网络状态：0停机 1开机
|
||||||
type: integer
|
type: integer
|
||||||
real_name_status:
|
real_name_status:
|
||||||
description: 实名状态
|
description: 实名状态：0未实名 1已实名
|
||||||
type: integer
|
type: integer
|
||||||
slot_position:
|
slot_position:
|
||||||
description: 插槽位置
|
description: 插槽位置
|
||||||
@@ -2241,13 +2364,13 @@ components:
|
|||||||
maximum: 120
|
maximum: 120
|
||||||
minimum: 1
|
minimum: 1
|
||||||
type: integer
|
type: integer
|
||||||
enable_realname_activation:
|
|
||||||
description: 是否启用实名激活 (true:需实名后激活, false:立即激活)
|
|
||||||
nullable: true
|
|
||||||
type: boolean
|
|
||||||
enable_virtual_data:
|
enable_virtual_data:
|
||||||
description: 是否启用虚流量
|
description: 是否启用虚流量
|
||||||
type: boolean
|
type: boolean
|
||||||
|
expiry_base:
|
||||||
|
description: 到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)
|
||||||
|
example: from_activation
|
||||||
|
type: string
|
||||||
package_code:
|
package_code:
|
||||||
description: 套餐编码
|
description: 套餐编码
|
||||||
maxLength: 100
|
maxLength: 100
|
||||||
@@ -2855,6 +2978,9 @@ components:
|
|||||||
description: IoT卡ID
|
description: IoT卡ID
|
||||||
minimum: 0
|
minimum: 0
|
||||||
type: integer
|
type: integer
|
||||||
|
is_current:
|
||||||
|
description: 是否为当前使用的卡
|
||||||
|
type: boolean
|
||||||
msisdn:
|
msisdn:
|
||||||
description: 接入号
|
description: 接入号
|
||||||
type: string
|
type: string
|
||||||
@@ -2912,6 +3038,137 @@ components:
|
|||||||
required:
|
required:
|
||||||
- identifier
|
- identifier
|
||||||
type: object
|
type: object
|
||||||
|
DtoDeviceGatewayInfo:
|
||||||
|
properties:
|
||||||
|
battery_level:
|
||||||
|
description: 电池电量百分比（无电池时为null）
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
connect_time:
|
||||||
|
description: 本次联网时间(秒)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
current_iccid:
|
||||||
|
description: 当前使用的ICCID
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
daily_usage:
|
||||||
|
description: 日使用流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_id:
|
||||||
|
description: Gateway设备ID(IMEI/SN)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_name:
|
||||||
|
description: Gateway返回的设备名称
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_type:
|
||||||
|
description: Gateway返回的设备类型
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
dl_stats:
|
||||||
|
description: 本次开机下载流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
imei:
|
||||||
|
description: IMEI号
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
imsi:
|
||||||
|
description: IMSI用户标识码
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
ip_address:
|
||||||
|
description: IP地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
lan_ip:
|
||||||
|
description: 局域网网关IP地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_online_time:
|
||||||
|
description: 设备最后在线时间
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_update_time:
|
||||||
|
description: 设备信息最后更新时间
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
limit_speed:
|
||||||
|
description: 限速速率(KB/s)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
mac_address:
|
||||||
|
description: MAC地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
max_clients:
|
||||||
|
description: 最大连接客户端数
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
online_status:
|
||||||
|
description: 在线状态：1=在线，2=离线
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rsrp:
|
||||||
|
description: 参考信号接收功率(dBm)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rsrq:
|
||||||
|
description: 参考信号接收质量(dB)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rssi:
|
||||||
|
description: 接收信号强度
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
run_time:
|
||||||
|
description: 本次开机运行时间(秒)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
sinr:
|
||||||
|
description: 信噪比(dB)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
software_version:
|
||||||
|
description: 软件版本号
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
ssid:
|
||||||
|
description: WiFi热点名称
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
status:
|
||||||
|
description: 设备状态：1=正常，0=禁用
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
switch_mode:
|
||||||
|
description: 切卡模式：0=自动，1=手动
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
sync_interval:
|
||||||
|
description: 信息上报周期(秒)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
ul_stats:
|
||||||
|
description: 本次开机上传流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
wan_ip:
|
||||||
|
description: 基站分配IPv4地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
wifi_enabled:
|
||||||
|
description: WiFi开关状态
|
||||||
|
nullable: true
|
||||||
|
type: boolean
|
||||||
|
wifi_password:
|
||||||
|
description: WiFi密码
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
DtoDeviceImportResultItemDTO:
|
DtoDeviceImportResultItemDTO:
|
||||||
properties:
|
properties:
|
||||||
line:
|
line:
|
||||||
@@ -3059,6 +3316,145 @@ components:
|
|||||||
description: 请求ID
|
description: 请求ID
|
||||||
type: string
|
type: string
|
||||||
type: object
|
type: object
|
||||||
|
DtoDeviceRealtimeInfo:
|
||||||
|
properties:
|
||||||
|
battery_level:
|
||||||
|
description: 电池电量百分比
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
connect_time:
|
||||||
|
description: 设备本次联网时间(秒)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
created_at:
|
||||||
|
description: Gateway创建时间(Unix时间戳)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
current_iccid:
|
||||||
|
description: 当前使用的ICCID
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
daily_usage:
|
||||||
|
description: 日使用流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_id:
|
||||||
|
description: Gateway设备ID(IMEI/SN)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_name:
|
||||||
|
description: Gateway返回的设备名称
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
device_type:
|
||||||
|
description: Gateway返回的设备型号
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
dl_stats:
|
||||||
|
description: 本次开机下载流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
imei:
|
||||||
|
description: Gateway返回的IMEI号
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
imsi:
|
||||||
|
description: Gateway返回的IMSI
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
ip_address:
|
||||||
|
description: IP地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
lan_ip:
|
||||||
|
description: 局域网网关IP地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_online_time:
|
||||||
|
description: 设备最后在线时间
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_update_time:
|
||||||
|
description: 设备信息最后更新时间
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
limit_speed:
|
||||||
|
description: 限速速率(KB/s)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
mac_address:
|
||||||
|
description: MAC地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
max_clients:
|
||||||
|
description: 最大连接客户端数
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
online_status:
|
||||||
|
description: 在线状态（1:在线, 2:离线）
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rsrp:
|
||||||
|
description: 参考信号接收功率(dBm)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rsrq:
|
||||||
|
description: 参考信号接收质量(dB)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
rssi:
|
||||||
|
description: 接收信号强度
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
run_time:
|
||||||
|
description: 设备本次开机运行时间(秒)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
sinr:
|
||||||
|
description: 信噪比(dB)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
software_version:
|
||||||
|
description: 软件版本号
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
ssid:
|
||||||
|
description: WiFi热点名称
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
status:
|
||||||
|
description: 设备状态（1:正常, 0:禁用）
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
switch_mode:
|
||||||
|
description: 切卡模式（0:自动, 1:手动）
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
sync_interval:
|
||||||
|
description: 信息上报周期(秒)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
ul_stats:
|
||||||
|
description: 本次开机上传流量(字节)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
updated_at:
|
||||||
|
description: Gateway更新时间(Unix时间戳)
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
|
wan_ip:
|
||||||
|
description: 基站分配IPv4地址
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
wifi_enabled:
|
||||||
|
description: WiFi开关状态
|
||||||
|
nullable: true
|
||||||
|
type: boolean
|
||||||
|
wifi_password:
|
||||||
|
description: WiFi密码
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
DtoDeviceRebootRequest:
|
DtoDeviceRebootRequest:
|
||||||
properties:
|
properties:
|
||||||
identifier:
|
identifier:
|
||||||
@@ -3108,12 +3504,25 @@ components:
|
|||||||
imei:
|
imei:
|
||||||
description: 设备IMEI
|
description: 设备IMEI
|
||||||
type: string
|
type: string
|
||||||
|
last_gateway_sync_at:
|
||||||
|
description: 最后 sync-info 同步时间
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
last_online_time:
|
||||||
|
description: 最后在线时间
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
manufacturer:
|
manufacturer:
|
||||||
description: 制造商
|
description: 制造商
|
||||||
type: string
|
type: string
|
||||||
max_sim_slots:
|
max_sim_slots:
|
||||||
description: 最大插槽数
|
description: 最大插槽数
|
||||||
type: integer
|
type: integer
|
||||||
|
online_status:
|
||||||
|
description: 在线状态：0未知 1在线 2离线
|
||||||
|
type: integer
|
||||||
series_id:
|
series_id:
|
||||||
description: 套餐系列ID
|
description: 套餐系列ID
|
||||||
minimum: 0
|
minimum: 0
|
||||||
@@ -3133,12 +3542,18 @@ components:
|
|||||||
sn:
|
sn:
|
||||||
description: 设备序列号
|
description: 设备序列号
|
||||||
type: string
|
type: string
|
||||||
|
software_version:
|
||||||
|
description: 固件版本号
|
||||||
|
type: string
|
||||||
status:
|
status:
|
||||||
description: 状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)
|
description: 状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)
|
||||||
type: integer
|
type: integer
|
||||||
status_name:
|
status_name:
|
||||||
description: 状态名称
|
description: 状态名称
|
||||||
type: string
|
type: string
|
||||||
|
switch_mode:
|
||||||
|
description: 切卡模式：0=自动，1=手动
|
||||||
|
type: string
|
||||||
updated_at:
|
updated_at:
|
||||||
description: 更新时间
|
description: 更新时间
|
||||||
format: date-time
|
format: date-time
|
||||||
@@ -4458,12 +4873,12 @@ components:
|
|||||||
duration_months:
|
duration_months:
|
||||||
description: 套餐时长(月数)
|
description: 套餐时长(月数)
|
||||||
type: integer
|
type: integer
|
||||||
enable_realname_activation:
|
|
||||||
description: 是否启用实名激活 (true:需实名后激活, false:立即激活)
|
|
||||||
type: boolean
|
|
||||||
enable_virtual_data:
|
enable_virtual_data:
|
||||||
description: 是否启用虚流量
|
description: 是否启用虚流量
|
||||||
type: boolean
|
type: boolean
|
||||||
|
expiry_base:
|
||||||
|
description: 到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)
|
||||||
|
type: string
|
||||||
id:
|
id:
|
||||||
description: 套餐ID
|
description: 套餐ID
|
||||||
minimum: 0
|
minimum: 0
|
||||||
@@ -6275,14 +6690,14 @@ components:
|
|||||||
minimum: 1
|
minimum: 1
|
||||||
nullable: true
|
nullable: true
|
||||||
type: integer
|
type: integer
|
||||||
enable_realname_activation:
|
|
||||||
description: 是否启用实名激活 (true:需实名后激活, false:立即激活)
|
|
||||||
nullable: true
|
|
||||||
type: boolean
|
|
||||||
enable_virtual_data:
|
enable_virtual_data:
|
||||||
description: 是否启用虚流量
|
description: 是否启用虚流量
|
||||||
nullable: true
|
nullable: true
|
||||||
type: boolean
|
type: boolean
|
||||||
|
expiry_base:
|
||||||
|
description: 到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
package_name:
|
package_name:
|
||||||
description: 套餐名称
|
description: 套餐名称
|
||||||
maxLength: 255
|
maxLength: 255
|
||||||
@@ -6497,6 +6912,15 @@ components:
|
|||||||
required:
|
required:
|
||||||
- status
|
- status
|
||||||
type: object
|
type: object
|
||||||
|
DtoUpdateRetailPriceParams:
|
||||||
|
properties:
|
||||||
|
retail_price:
|
||||||
|
description: 零售价（单位：分）
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
required:
|
||||||
|
- retail_price
|
||||||
|
type: object
|
||||||
DtoUpdateRoleParams:
|
DtoUpdateRoleParams:
|
||||||
properties:
|
properties:
|
||||||
role_desc:
|
role_desc:
|
||||||
@@ -8467,8 +8891,23 @@ paths:
|
|||||||
- 资产管理
|
- 资产管理
|
||||||
/api/admin/assets/{asset_type}/{id}/packages:
|
/api/admin/assets/{asset_type}/{id}/packages:
|
||||||
get:
|
get:
|
||||||
description: 查询该资产所有套餐记录，含虚流量换算结果。
|
description: 查询该资产所有套餐记录，含虚流量换算结果。支持分页（默认 page=1, page_size=50, 最大100）。
|
||||||
parameters:
|
parameters:
|
||||||
|
- description: 页码（默认1）
|
||||||
|
in: query
|
||||||
|
name: page
|
||||||
|
schema:
|
||||||
|
description: 页码（默认1）
|
||||||
|
minimum: 1
|
||||||
|
type: integer
|
||||||
|
- description: 每页条数（默认50，最大100）
|
||||||
|
in: query
|
||||||
|
name: page_size
|
||||||
|
schema:
|
||||||
|
description: 每页条数（默认50，最大100）
|
||||||
|
maximum: 100
|
||||||
|
minimum: 1
|
||||||
|
type: integer
|
||||||
- description: 资产类型：card 或 device
|
- description: 资产类型：card 或 device
|
||||||
in: path
|
in: path
|
||||||
name: asset_type
|
name: asset_type
|
||||||
@@ -8495,9 +8934,7 @@ paths:
|
|||||||
example: 0
|
example: 0
|
||||||
type: integer
|
type: integer
|
||||||
data:
|
data:
|
||||||
items:
|
$ref: '#/components/schemas/DtoAssetPackagesResult'
|
||||||
$ref: '#/components/schemas/DtoAssetPackageResponse'
|
|
||||||
type: array
|
|
||||||
msg:
|
msg:
|
||||||
description: 响应消息
|
description: 响应消息
|
||||||
example: success
|
example: success
|
||||||
@@ -15680,6 +16117,52 @@ paths:
|
|||||||
summary: 更新套餐
|
summary: 更新套餐
|
||||||
tags:
|
tags:
|
||||||
- 套餐管理
|
- 套餐管理
|
||||||
|
/api/admin/packages/{id}/retail-price:
|
||||||
|
patch:
|
||||||
|
parameters:
|
||||||
|
- description: ID
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
description: ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/DtoUpdateRetailPriceParams'
|
||||||
|
responses:
|
||||||
|
"400":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
description: 请求参数错误
|
||||||
|
"401":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
description: 未认证或认证已过期
|
||||||
|
"403":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
description: 无权访问
|
||||||
|
"500":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
description: 服务器内部错误
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: 修改零售价（代理）
|
||||||
|
tags:
|
||||||
|
- 套餐管理
|
||||||
/api/admin/packages/{id}/shelf:
|
/api/admin/packages/{id}/shelf:
|
||||||
patch:
|
patch:
|
||||||
parameters:
|
parameters:
|
||||||
@@ -20574,6 +21057,22 @@ paths:
|
|||||||
maxLength: 50
|
maxLength: 50
|
||||||
minLength: 1
|
minLength: 1
|
||||||
type: string
|
type: string
|
||||||
|
- description: 套餐类型 (formal:正式套餐, addon:加油包)
|
||||||
|
in: query
|
||||||
|
name: package_type
|
||||||
|
schema:
|
||||||
|
description: 套餐类型 (formal:正式套餐, addon:加油包)
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
- description: 套餐状态 (0:待生效, 1:生效中, 2:已用完, 3:已过期, 4:已失效)
|
||||||
|
in: query
|
||||||
|
name: status
|
||||||
|
schema:
|
||||||
|
description: 套餐状态 (0:待生效, 1:生效中, 2:已用完, 3:已过期, 4:已失效)
|
||||||
|
maximum: 4
|
||||||
|
minimum: 0
|
||||||
|
nullable: true
|
||||||
|
type: integer
|
||||||
- description: 页码
|
- description: 页码
|
||||||
in: query
|
in: query
|
||||||
name: page
|
name: page
|
||||||
|
|||||||
Reference in New Issue
Block a user