Skip to content

Get Friend Relationship

Deprecated
GET
/friends/v1/player/{player_id}/friend/{other_player_id}

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 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

Authorizations

Parameters

Path Parameters

player_id
required
integer
other_player_id
required
integer

Header Parameters

if-none-match

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.

string

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

Successful Response

Represents the relationship with a potential friend. V1 includes player_id and player_uuid.

object
friends_player_uuid
required
string format: uuid
friends_player_id
integer
status
required
string
Allowed values: NONE FRIENDS FRIEND_REQUEST_SENT FRIEND_REQUEST_PENDING FRIEND_REQUEST_DECLINED_BY_OTHER
notes
string
last_modified_on
required
string format: date-time

Headers

ETag
string

Used to identify this version of the content. Provide with a get request to avoid downloading the same data multiple times.

304

Content still has the same etag and has not changed

400

Bad Request

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

403

Forbidden

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

409

Conflict

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string