跳到主要内容

获取账号列表

分页查询 NineData 账号列表,支持通过账号 ID、账号名称、账号登录名进行过滤。

请求地址:/openapi/v1/account/list

请求方法:GET

请求参数

参数类型是否必选说明示例
accountIdString账号 ID。170**********159
accountNameString账号名称。NineData
loginNameString账号登录名。138********
currentInteger当前页码,从 1 开始,默认 1。1
pageSizeInteger分页大小,默认 10。10

返回参数

参数类型说明示例
successBool接口调用是否成功。返回值:turefalseture
requestIdString请求 ID。Ww2k2GVI-DJGGvSDnEJKv3PFdHIp6ETC
dataArray账号列表,包含账号信息和角色信息。
账号信息:
  • accountId:账号 ID。
  • accountName:账号名称。
  • loginName:账号登录名。
  • status:账号状态。返回值:
    • normal:正常。
    • freeze:冻结。
    • inviting:邀请中。
  • accountType:账号类型。返回值:
    • general:普通账号。
    • sso:SSO 单点登录账号。
  • mobile:手机号码。
  • mail:邮箱。
  • lastLoginTime:最后登录时间。
  • roleList:角色列表。
角色信息:
  • roleId:角色 ID。
  • name:角色名称。
  • type:角色类型。返回值:
    • system:系统管理员。
    • custom:普通角色。
{
"accountId": "170**********159",
"accountName": "NineData",
"loginName": "138********",
"status": "normal",
"accountType": "general",
"mobile": "138********",
"mail": "g**@9z.cloud",
"lastLoginTime": "2025-08-04 03:41:39Z",
"roleList": [{
"roleId": "635",
"name": "系统管理员",
"type": "system"
}
currentInteger当前页码。1
pageSizeInteger每页的大小。10
totalInteger账号的总数。4

调用成功示例

{
"success": true,
"requestId": "Rv6t8FZX-JPNMqTHnKPQd1DHdRLw4DTQ",
"data": [{
"accountId": "170**********159",
"accountName": "NineData",
"loginName": "138********",
"status": "normal",
"accountType": "general",
"mobile": "138********",
"mail": "g**@9z.cloud",
"lastLoginTime": "2025-08-04 03:41:39Z",
"roleList": [{
"roleId": "635",
"name": "系统管理员",
"type": "system"
}]
}],
"current": 1,
"pageSize": 10,
"total": 1
}