Skip to main content

Check Friend Relationship

Brief Description

  • Check if two users have a friend relationship.

Request Method

  • post

Request URL

  • {API_ADDRESS}/friend/is_friend
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global link tracking, timestamp is recommended, independent in each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameter Example

{
"userID1": "11111111",
"userID2": "11111112"
}
Field NameOptionalTypeDescription
userID1RequiredstringUser ID
userID2RequiredstringUser ID

Success Return Example

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"inUser1Friends": true,
"inUser2Friends": true
}
}

Parameter Description for Success Return Example

Parameter NameTypeDescription
errCodeintError code, 0 means success
errMsgstringBrief error message, empty
errDlterrDltDetailed error message, empty
dataobjectGeneral data object, see structure below
inUser1Friendsbooleantrue: userID2 is in userID1's friend list
inUser2Friendsbooleantrue: userID1 is in userID2's friend list

Failure Return Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Parameter Description for Failure Return Example

Parameter NameTypeDescription
errCodeintError code, see global error code document for details
errMsgstringBrief error message
errDlterrDltDetailed error message