🤝Friend

Friend List

Get Friend List

GET [endpoint]/v3/friend/list

online_only will show friends that make API activity on last 30 seconds. Currently this feature is not reliable if no game send user's activity via REST API. This will have better reliability after development of WebSocket as we will ping-pong the user every 5 seconds.

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
favorite_only	Boolean	Only show favorite friends. Default false
online_only	Boolean	Only show online friends (read notes above). Default false
limit	Integer	Limit amount of data shows. Default no limit
offset	Integer	Start showing data from number of offset. Default no offset

200: OK

{
    "status": "success",
    "data": [
        {
            "komo_username": "kokomo",
            "in_game_display_name": "[PBR] Komodo",
            "profile_picture_url": "https://komo.s3.ap-southeast-1.amazonaws.com/profile-account/kokomo-XYXJ.jpg",
            "is_favorite": 0,
            "last_online": "2023-06-27 07:38:17"
        },
        ....
        {
            "komo_username": "dasdsa",
            "in_game_display_name": "dasdsa",
            "profile_picture_url": null,
            "is_favorite": 0,
            "last_online": "2023-06-27 07:37:51"
        }
    ]
}

Friend Request

Make a Friend Request

POST [endpoint]/v3/friend/request

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
target_komo_username*	String	KOMO username to make friend request

400: Bad Request Friend request to itself

{
    "status": "error",
    "messages": "Can not make friend request to itself"
}

200: OK

{
    "status": "success",
    "messages": "Friend request sent"
}

400: Bad Request Request already made

{
    "status": "error",
    "messages": "Friend request to this user already made"
}

Get Incoming Friend Request

GET [endpoint]/v3/friend/request/incoming

200: OK

{
    "status": "success",
    "data": [
        {
            "relation_id": 1,
            "requester": "Aviabee",
            "requestee": "kokomo",
            "is_accepted": 0,
            "request_time": "2023-06-27 03:51:15",
            "accept_time": null
        },
        {
            "relation_id": 4,
            "requester": "polycrest",
            "requestee": "kokomo",
            "is_accepted": 0,
            "request_time": "2023-06-27 04:04:55",
            "accept_time": null
        }
    ]
}

Get Outgoing Friend Request

GET [endpoint]/v3/friend/request/outgoing

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

200: OK

{
    "status": "success",
    "data": [
        {
            "relation_id": 1,
            "requester": "Aviabee",
            "requestee": "kokomo",
            "is_accepted": 0,
            "request_time": "2023-06-27 03:51:15",
            "accept_time": null
        },
        {
            "relation_id": 2,
            "requester": "Aviabee",
            "requestee": "dasdsa",
            "is_accepted": 0,
            "request_time": "2023-06-27 03:59:38",
            "accept_time": null
        },
        {
            "relation_id": 3,
            "requester": "Aviabee",
            "requestee": "polycrest",
            "is_accepted": 0,
            "request_time": "2023-06-27 03:59:44",
            "accept_time": null
        }
    ]
}

Accepting Friend Request

Accepting a Friend Request

POST [endpoint]/v3/friend/request/accept

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
relation_id*	Integer	Relation ID

200: OK

{
    "status": "success",
    "messages": "Friend request accepted"
}

400: Bad Request relation_id is not for this user

{
    "status": "error",
    "messages": "You are not authorized to accept this relation"
}

Accepting All Pending Friend Request

GET [endpoint]/v3/friend/request/accept-all

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

200: OK

{
    "status": "success",
    "messages": "All pending friend request accepted"
}

400: Bad Request No pending request

{
    "status": "error",
    "messages": "No pending friend request"
}

Favorite Friends

Adding Friend to Favorites

POST [endpoint]/v3/friend/favorites/add

Headers

Name	Type	Description
Authorization*	String	Bearer Token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
target_komo_username*	String	KOMO username to add favorites

200: OK

{
    "status": "success",
    "messages": "Friend added to favorites"
}

400: Bad Request already favorited

{
    "status": "error",
    "messages": "Already added to favorites"
}

Removing Friend from Favorites

POST [endpoint]/v3/friend/favorites/remove

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
target_komo_username*	String	KOMO username to remove favorites

200: OK

{
    "status": "success",
    "messages": "Friend removed from favorites"
}

400: Bad Request friend not in fav list

{
    "status": "error",
    "messages": "Friend is not on favorite list"
}

Removing Friend

Removing a Friend from Friend List

POST [endpoint]/v3/friend/remove

WARNING!!! This will remove friend relation from both friend list

Headers

Name	Type	Description
Authorization*	String	Bearer token
X-Api-Key*	String	API Key

Request Body

Name	Type	Description
target_komo_username*	String	KOMO username of friends to remove

200: OK

{
    "status": "success",
    "messages": "Friend removed successfully"
}

400: Bad Request User not friend with target

{
    "status": "error",
    "messages": "Friend relation not found"
}