获取系统通知号
简要描述
- 管理员可以获取所创建的系统通知号列表,包括 ID、头像和名称。
请求方式
post
请求 URL
{API_ADDRESS}/user/search_notification_account
Header
header 名 | 示例值 | 选填 | 类型 | 说明 |
---|---|---|---|---|
operationID | 1646445464564 | 必填 | string | 用于全局链路追踪,建议使用时间戳,在每个请求中独立 |
token | eyJhbxxxx3Xs | 必填 | string | 管理员 token |
请求参数示例
{
"keyword": "",
"pagination": {
"pageNumber": 1,
"showNumber": 10
}
}
字段名 | 选填 | 类型 | 说明 |
---|---|---|---|
keyword | 选填 | string | 填写 userID 或 nickname,不填时默认返回对应分页的系统通知号 |
pagination | 必填 | object | 分页参数结构体 |
pagination.pageNumber | 必填 | int | 当前页码,从 1 开始 |
pagination.showNumber | 必填 | int | 当前页请求数量 |
成功返回示例
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"total": 5,
"notificationAccounts": [
{
"userID": "1974356875",
"faceURL": "url",
"nickName": "notification1111111"
},
{
"userID": "8719627904",
"faceURL": "",
"nickName": "notification1"
},
{
"userID": "4208409642",
"faceURL": "",
"nickName": "notification1"
},
{
"userID": "2776836221",
"faceURL": "",
"nickName": "notification1"
}
]
}
}
成功返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,0 表示成功 |
errMsg | string | 错误简要信息,为空 |
errDlt | errDlt | 错误详细信息,为空 |
data | object | 通用数据对象,具体结构见下方 |
total | int | 系统通知号总数 |
notificationAccounts | array | 系统通知号列表 |
userID | string | 系统通知号 ID |
faceURL | string | 系统通知号头像 |
nickName | string | 系统通知号名称 |
失败返回示例
{
"errCode": 1001,
"errMsg": "ArgsError",
"errDlt": "1001 ArgsError"
}
失败返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,具体查看全局错误码文档 |
errMsg | string | 错误简要信息 |
errDlt | errDlt | 错误详细信息 |