开放平台

获取子账号角色列表

GET

https://saas-open.vhall.com/v3/users/child-role/get-list

调用频率限制:
单用户请求频率限制为 120 次/分钟，如果频率超出限制，请参调用频率说明

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://saas-open.vhall.com/v3/users/child-role/get-list?app_key=75844ad7a2a5f2b421c04a125b197996&sign_type=0&signed_at={% mock 'timestamp' , 's' %}&sign={{sign}}&pos=0&limit=10' \
--header 'platform: 15'

响应示例

{
    "code": 200,
    "msg": "",
    "data": {
        "total": 4,
        "list": [
            {
                "id": 11337,
                "role_name": "阿布索留特一族",
                "remark": "",
                "child_count": 0
            },
            {
                "id": 11197,
                "role_name": "奥特兄弟",
                "remark": "",
                "child_count": 2
            },
            {
                "id": 2677,
                "role_name": "新七龙珠",
                "remark": "",
                "child_count": 1
            },
            {
                "id": 2261,
                "role_name": "平成三杰",
                "remark": "",
                "child_count": 4
            }
        ]
    },
    "request_id": "e8c48281-5b81-4cfb-93a4-ccad00071396"
}

请求参数

Query 参数

app_key

string

APPKEY

必需

示例值:

sign_type

string

必需

签名类型:0=MD5,1=RSA,2=SHA256,3=SM3

示例值:

signed_at

string

签名时间

必需

示例值:

sign

string

签名值

必需

示例值:

role_name

string

角色名称

可选

pos

string

必需

第几条开始取，默认0

示例值:

limit

string

偏移量，最大100

必需

示例值:

Header 参数

platform

integer

可选

默认值:

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回结果的状态码（200 成功)

msg

string

必需

当返回结果的状态码不为200时，包含的错误信息

data

object

必需

total

integer

总数

必需

list

array [object {4}]

必需

request_id

string

必需

修改于 2025-06-19 01:10:42

创建子账号角色

获取子账号角色详情