用户列表
用户列表
1. 描述
获取当前客户下的用户列表
2. 请求地址
请求地址的格式如下:
https://api.yovole.com/v1/user/list
3. 请求参数
Name | Type | Description | Required |
---|---|---|---|
userName | String | 用户名称 | 否 |
curPage | Integer | 当前页码,默认值1 | 否 |
perPage | Integer | 每页显示条数,默认值10 | 否 |
4. 请求示例
4.1. 请求地址
POST https://api.yovole.com/v1/user/list HTTP/1.1
x-ycs-timestamp: 2019-06-19T14:26:26Z
x-ycs-requestid: 2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9
x-ycs-security-authorization: Authorization: YCS1-HMAC-SHA1 Credential=08e206fb-7b41-45b7-8076-8d43e8aeea89,SignedHeaders=content-type;x-ycs-requestid;x-ycs-timestamp,Signature=2RFjU7C9gICCrQfpAIfAJHqRRlQ=
4.2. 接口请求参数
{
"curPage":1,
"perPage":10
}
5. 返回结果
5.1. 返回正确结果示例
{
"requestId":"934655d6-35e8-4a23-8135-934c7855e17d",
"success":true,
"code":200,
"pager":{
"curPage":1,
"perPage":10,
"totalRecords":2,
"totalPages":1,
"pageData":[
{
"id":"2c9481e06554f46d016556900a670009",
"userName":"XXXX",
"email":"xxx@xxx.xxx"
},
{
"id":"8a83a0966a58d52c016a6373baad003c",
"userName":"xxxxx",
"email":"xxxx@xxx.xxx"
}
]
}
}
5.2. 返回错误结果示例
{
"requestId": "627f35ac-178e-4aaf-a283-4130bfa6cc89",
"success": false,
"code": 403,
"message": "permission denied",
"errorCode": "PermissionDenied"
}
6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码,错误码信息和简单的错误分析方法可以参考公共错误码。