get_friend_list
Brief Description
- Retrieve the friend list of a specified user.
Request Method
post
Request URL
http://x.x.x.x:10002/friend/get_friend_list
Header
Header Name | Example Value | Optional | Type | Description |
---|---|---|---|---|
operationID | 1646445464564 | Required | string | operationID is used for global link tracking |
token | eyJhbxxxx3Xs | Required | string | Administrator token |
Request Sample Parameters
{
"userID": "11111111",
"pagination": {
"pageNumber": 1,
"showNumber": 100
}
}
Field Name | Optional | Type | Description |
---|---|---|---|
userID | Required | string | User ID |
pagination | Required | object | Pagination parameter structure |
pagination.pageNumber | Required | int | Current page number, starting from 1 |
pagination.showNumber | Required | int | Number of requests on the current page |
Successful Return Sample
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"friendsInfo": [
{
"ownerUserID": "11111111",
"remark": "",
"createTime": 1688458955,
"friendUser": {
"userID": "11111112",
"nickname": "alantestuid3",
"faceURL": "1111111",
"ex": "",
"createTime": 0,
"appMangerLevel": 0,
"globalRecvMsgOpt": 0
},
"addSource": 2,
"operatorUserID": "11111111",
"ex": ""
},
{
"ownerUserID": "11111111",
"remark": "",
"createTime": 1688459860,
"friendUser": {
"userID": "11111113",
"nickname": "yourNickname",
"faceURL": "yourFaceURL",
"ex": "",
"createTime": 0,
"appMangerLevel": 0,
"globalRecvMsgOpt": 0
},
"addSource": 2,
"operatorUserID": "11111111",
"ex": ""
}
],
"total": 2
}
}
Successful Return Sample Explanation
Parameter Name | Type | Description |
---|---|---|
errCode | int | Error code, 0 indicates success |
errMsg | string | Brief error message, empty when no error |
errDlt | errDlt | Detailed error message, empty when no error |
data | object | General data object, specific structure shown below |
friendsInfo | array | List of Friend Information |
total | int | Total number of returned friends |
Failed Return Sample
{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": "[1004]RecordNotFoundError"
}
Failed Return Sample Explanation
Parameter Name | Type | Description |
---|---|---|
errCode | int | Error code, refer to the global error code document |
errMsg | string | Brief error message |
errDlt | errDlt | Detailed error message |