子帐号管理接口

获取子帐号列表

URL: GET /sub/subuser/list?page=1

Query:

字段 必填 说明
page 否 页码，从1开始
size 否 每页大小
search 否 搜索关键词
status 否 子帐号状态, NORMAL正常, SUSPENDED已停用

输出: list<Subuser>

Subuser

字段 类型 说明
id string id
main_user_id string 主帐号ID
main_user User 主帐号信息
username string 邮箱/用户名
role string 角色
area_code string 手机区号, 如852
mobile string 手机号，如13900000000
name string 名称
status string 状态, NORMAL正常, SUSPENDED已停用
remark string 子帐号备注
max_prepaid_card_count number 最大储值卡可开卡数
prepaid_card_count number 储值卡已开卡数
max_credit_card_count number 最大额度卡可开卡数
credit_card_count number 额度卡已开卡数
balance number 钱包余额, 单位元
prepaid_card_balance number 储值卡总余额, 单位元
total_credit_budget number 额度卡预算剩余可用, 单位元
last_login string 最后登录时间
created_at string 创建时间
updated_at string 更新时间

新增子帐号

URL: POST /sub/subuser/create

输入:

字段 类型 必填 说明
main_user_id string 是 主帐号ID
username string 是 邮箱(用户名)
area_code string 是 手机区号, 如852
mobile string 是 手机号，如13900000000
name string 是 子帐号名称
status string 是 状态, NORMAL正常, SUSPENDED已停用
password string 是 密码
remark string 否 子帐号备注

输出:

字段 类型 说明
id string id

编辑子帐号

URL: POST /sub/subuser/{subuser_id}/update

输入:

字段 类型 必填 说明
username string 是 邮箱(用户名)
area_code string 是 手机区号, 如852
mobile string 是 手机号，如13900000000
name string 是 子帐号名称
status string 是 状态, NORMAL正常, SUSPENDED已停用
remark string 否 子帐号备注
password string 否 密码如果不填，表示不更新密码

输出: 无

修改子帐号状态

URL: POST /sub/subuser/{subuser_id}/change_status

输入:

字段 类型 必填 说明
status string 是 状态, NORMAL正常, SUSPENDED已停用

输出: 无

删除子帐号

URL: POST /sub/subuser/{subuser_id}/delete

输入: 无

输出: 无

修改子帐号可开卡数

URL: POST /sub/subuser/{subuser_id}/change_card_count

输入:

字段 类型 必填 说明
card_type string 是 卡片类型, PREPAID-储值卡, CREDIT-额度卡
operation string 是 操作, ADD-增加, REDUCE-减少
card_count number 是 数量

输出: 无

子帐号充值

注意: 当前仅支持从钱包充值

URL: POST /sub/subuser/{subuser_id}/recharge

输入:

字段 类型 必填 说明
amount number 是 充值金额
所有金额都是整数且精确到分，如1850，表示18.5元

输出:

字段 类型 说明
subuser_balance number 子帐号新余额, 单位元
mainuser_balance number 主帐号新余额, 单位元

子帐号转出

注意: 当前仅支持转出到钱包

URL: POST /sub/subuser/{subuser_id}/transfer_out

输入:

字段 类型 必填 说明
amount number 是 转出金额
所有金额都是整数且精确到分，如1850，表示18.5元

输出:

字段 类型 说明
subuser_balance number 子帐号新余额, 单位元
mainuser_balance number 主帐号新余额, 单位元