Get Friend Relationship V2
GET/friends/v2/player/:player_uuid/friend/:other_player_uuid
Get the relationship status with the other Player.
Note: This API supports etags and will return the etag header when with the response.
Clients can then utilize the if-none-match header to avoid having to reload the response if it has not changed or to use it to modify the relationship without loosing updates.
Permissions Required: friend:friend_list:read
Request
Path Parameters
Header Parameters
If you provide the ETag that matches the current ETag for this resource, a 304 response will be return - indicating that the resource has not changed.
Responses
- 200
- 304
- 400
- 403
- 409
- 422
Successful Response
Response Headers
ETag
string
Used to identify this version of the content. Provide with a get request to avoid downloading the same data multiple times.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [NONE, FRIENDS, FRIEND_REQUEST_SENT, FRIEND_REQUEST_PENDING, FRIEND_REQUEST_DECLINED_BY_OTHER]
An enumeration.
{
"friends_player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "NONE",
"notes": "string",
"last_modified_on": "2024-07-29T15:51:28.071Z"
}
Content still has the same etag and has not changed
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Default value: true
{
"auth_success": true,
"error_code": "string",
"desc": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Default value: true
{
"auth_success": true,
"error_code": "string",
"desc": "string"
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
Default value: true
{
"auth_success": true,
"error_code": "string",
"desc": "string"
}
Validation Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
- MOD1
- MOD2
]
]
detail
object[]
loc
object[]
required
anyOf
string
integer
{
"detail": [
{
"loc": [
"string",
0
],
"msg": "string",
"type": "string"
}
]
}