docs: 更新 admin OpenAPI 文档，新增 asset_wallet 接口定义
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m57s
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m57s
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
@@ -520,8 +520,9 @@ components:
|
|||||||
DtoAssetPackageResponse:
|
DtoAssetPackageResponse:
|
||||||
properties:
|
properties:
|
||||||
activated_at:
|
activated_at:
|
||||||
description: 激活时间
|
description: 激活时间（待生效套餐为空）
|
||||||
format: date-time
|
format: date-time
|
||||||
|
nullable: true
|
||||||
type: string
|
type: string
|
||||||
created_at:
|
created_at:
|
||||||
description: 创建时间
|
description: 创建时间
|
||||||
@@ -534,8 +535,9 @@ components:
|
|||||||
description: 已用真流量(MB)
|
description: 已用真流量(MB)
|
||||||
type: integer
|
type: integer
|
||||||
expires_at:
|
expires_at:
|
||||||
description: 到期时间
|
description: 到期时间（待生效套餐为空）
|
||||||
format: date-time
|
format: date-time
|
||||||
|
nullable: true
|
||||||
type: string
|
type: string
|
||||||
master_usage_id:
|
master_usage_id:
|
||||||
description: 主套餐ID（加油包时有值）
|
description: 主套餐ID（加油包时有值）
|
||||||
@@ -759,6 +761,105 @@ components:
|
|||||||
description: 虚拟号
|
description: 虚拟号
|
||||||
type: string
|
type: string
|
||||||
type: object
|
type: object
|
||||||
|
DtoAssetWalletResponse:
|
||||||
|
properties:
|
||||||
|
available_balance:
|
||||||
|
description: 可用余额 = balance - frozen_balance（分）
|
||||||
|
type: integer
|
||||||
|
balance:
|
||||||
|
description: 总余额（分）
|
||||||
|
type: integer
|
||||||
|
created_at:
|
||||||
|
description: 创建时间（RFC3339）
|
||||||
|
format: date-time
|
||||||
|
type: string
|
||||||
|
currency:
|
||||||
|
description: 币种，目前固定 CNY
|
||||||
|
type: string
|
||||||
|
frozen_balance:
|
||||||
|
description: 冻结余额（分）
|
||||||
|
type: integer
|
||||||
|
resource_id:
|
||||||
|
description: 对应卡或设备的数据库ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
resource_type:
|
||||||
|
description: 资源类型：iot_card 或 device
|
||||||
|
type: string
|
||||||
|
status:
|
||||||
|
description: 钱包状态：1-正常 2-冻结 3-关闭
|
||||||
|
type: integer
|
||||||
|
status_text:
|
||||||
|
description: 状态文本
|
||||||
|
type: string
|
||||||
|
updated_at:
|
||||||
|
description: 更新时间（RFC3339）
|
||||||
|
format: date-time
|
||||||
|
type: string
|
||||||
|
wallet_id:
|
||||||
|
description: 钱包数据库ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
type: object
|
||||||
|
DtoAssetWalletTransactionItem:
|
||||||
|
properties:
|
||||||
|
amount:
|
||||||
|
description: 变动金额（分），充值为正数，扣款/退款为负数
|
||||||
|
type: integer
|
||||||
|
balance_after:
|
||||||
|
description: 变动后余额（分）
|
||||||
|
type: integer
|
||||||
|
balance_before:
|
||||||
|
description: 变动前余额（分）
|
||||||
|
type: integer
|
||||||
|
created_at:
|
||||||
|
description: 流水创建时间（RFC3339）
|
||||||
|
format: date-time
|
||||||
|
type: string
|
||||||
|
id:
|
||||||
|
description: 流水记录ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
reference_no:
|
||||||
|
description: 关联业务编号：充值单号（CRCH…）或订单号（ORD…）（可空）
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
reference_type:
|
||||||
|
description: 关联业务类型：recharge 或 order（可空）
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
remark:
|
||||||
|
description: 备注（可空）
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
transaction_type:
|
||||||
|
description: 交易类型：recharge/deduct/refund
|
||||||
|
type: string
|
||||||
|
transaction_type_text:
|
||||||
|
description: 交易类型文本：充值/扣款/退款
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
DtoAssetWalletTransactionListResponse:
|
||||||
|
properties:
|
||||||
|
list:
|
||||||
|
description: 流水列表
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/DtoAssetWalletTransactionItem'
|
||||||
|
nullable: true
|
||||||
|
type: array
|
||||||
|
page:
|
||||||
|
description: 当前页码
|
||||||
|
type: integer
|
||||||
|
page_size:
|
||||||
|
description: 每页数量
|
||||||
|
type: integer
|
||||||
|
total:
|
||||||
|
description: 总记录数
|
||||||
|
type: integer
|
||||||
|
total_pages:
|
||||||
|
description: 总页数
|
||||||
|
type: integer
|
||||||
|
type: object
|
||||||
DtoAssignPermissionsParams:
|
DtoAssignPermissionsParams:
|
||||||
properties:
|
properties:
|
||||||
perm_ids:
|
perm_ids:
|
||||||
@@ -3365,6 +3466,9 @@ components:
|
|||||||
virtual_data_mb:
|
virtual_data_mb:
|
||||||
description: 虚流量额度(MB)
|
description: 虚流量额度(MB)
|
||||||
type: integer
|
type: integer
|
||||||
|
virtual_ratio:
|
||||||
|
description: 虚流量比例(real_data_mb/virtual_data_mb)，启用虚流量时计算，否则为1.0
|
||||||
|
type: number
|
||||||
type: object
|
type: object
|
||||||
DtoPackageSeriesPageResult:
|
DtoPackageSeriesPageResult:
|
||||||
properties:
|
properties:
|
||||||
@@ -7141,6 +7245,191 @@ paths:
|
|||||||
summary: 刷新资产状态
|
summary: 刷新资产状态
|
||||||
tags:
|
tags:
|
||||||
- 资产管理
|
- 资产管理
|
||||||
|
/api/admin/assets/{asset_type}/{id}/wallet:
|
||||||
|
get:
|
||||||
|
description: 查询指定卡或设备的钱包余额概况。企业账号禁止调用。
|
||||||
|
parameters:
|
||||||
|
- description: 资产类型：card 或 device
|
||||||
|
in: path
|
||||||
|
name: asset_type
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
description: 资产类型：card 或 device
|
||||||
|
type: string
|
||||||
|
- description: 资产ID
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
description: 资产ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
description: 响应码
|
||||||
|
example: 0
|
||||||
|
type: integer
|
||||||
|
data:
|
||||||
|
$ref: '#/components/schemas/DtoAssetWalletResponse'
|
||||||
|
msg:
|
||||||
|
description: 响应消息
|
||||||
|
example: success
|
||||||
|
type: string
|
||||||
|
timestamp:
|
||||||
|
description: 时间戳
|
||||||
|
format: date-time
|
||||||
|
type: string
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- msg
|
||||||
|
- data
|
||||||
|
- timestamp
|
||||||
|
type: object
|
||||||
|
description: 成功
|
||||||
|
"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/assets/{asset_type}/{id}/wallet/transactions:
|
||||||
|
get:
|
||||||
|
description: 分页查询指定资产的钱包收支流水，含充值/扣款来源编号。企业账号禁止调用。
|
||||||
|
parameters:
|
||||||
|
- description: 页码，默认1
|
||||||
|
in: query
|
||||||
|
name: page
|
||||||
|
schema:
|
||||||
|
description: 页码，默认1
|
||||||
|
type: integer
|
||||||
|
- description: 每页数量，默认20，最大100
|
||||||
|
in: query
|
||||||
|
name: page_size
|
||||||
|
schema:
|
||||||
|
description: 每页数量，默认20，最大100
|
||||||
|
type: integer
|
||||||
|
- description: 交易类型过滤：recharge/deduct/refund
|
||||||
|
in: query
|
||||||
|
name: transaction_type
|
||||||
|
schema:
|
||||||
|
description: 交易类型过滤：recharge/deduct/refund
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
- description: 开始时间（RFC3339）
|
||||||
|
in: query
|
||||||
|
name: start_time
|
||||||
|
schema:
|
||||||
|
description: 开始时间（RFC3339）
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
- description: 结束时间（RFC3339）
|
||||||
|
in: query
|
||||||
|
name: end_time
|
||||||
|
schema:
|
||||||
|
description: 结束时间（RFC3339）
|
||||||
|
format: date-time
|
||||||
|
nullable: true
|
||||||
|
type: string
|
||||||
|
- description: 资产类型：card 或 device
|
||||||
|
in: path
|
||||||
|
name: asset_type
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
description: 资产类型：card 或 device
|
||||||
|
type: string
|
||||||
|
- description: 资产ID
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
description: 资产ID
|
||||||
|
minimum: 0
|
||||||
|
type: integer
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
description: 响应码
|
||||||
|
example: 0
|
||||||
|
type: integer
|
||||||
|
data:
|
||||||
|
$ref: '#/components/schemas/DtoAssetWalletTransactionListResponse'
|
||||||
|
msg:
|
||||||
|
description: 响应消息
|
||||||
|
example: success
|
||||||
|
type: string
|
||||||
|
timestamp:
|
||||||
|
description: 时间戳
|
||||||
|
format: date-time
|
||||||
|
type: string
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- msg
|
||||||
|
- data
|
||||||
|
- timestamp
|
||||||
|
type: object
|
||||||
|
description: 成功
|
||||||
|
"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/assets/card/{iccid}/start:
|
/api/admin/assets/card/{iccid}/start:
|
||||||
post:
|
post:
|
||||||
description: 手动复机单张卡（通过ICCID）。受设备保护期约束。
|
description: 手动复机单张卡（通过ICCID）。受设备保护期约束。
|
||||||
|
|||||||
Reference in New Issue
Block a user