友達の管理

印刷する
共有
PDF

友達の管理

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

友達管理

友達リクエスト

他のユーザーに友達リクエストを送信します。受信者はそのリクエストの通知を受け取ります。

Request

Method : POST
URI : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/request

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/request
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
    "userId": "80803902-8b83-4860-b8a6-xxxxxxxx",
    "friendId": "a1c4aaa2-02f6-40bd-afb4-xxxxxxx",
    "message": "友達になりましょう!!"
}

Header	Type	Required	Description
X-API-KEY	String	O	GamePotで発行する認証キー
X-PROJECT-ID	String	O	ダッシュボードプロジェクト ID

Attribute	Type	Required	Description
userId	String	O	ユーザー ID
friendId	String	O	友達追加 ID
message	String	X	メッセージ

Response

成功

{
   "friendship": {
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxx",
        "id": "5fe78d95-6186-4128-b52a-28759cxxxxxx",
        "status": "requested",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id": "a1c4aaa2-02f6-40bd-afb4-b1d6caacf0de",
        "requested_at": "2023-01-31T16:13:26-08:00"
    }
}

Attribute	Type	Description
friendship.project_id	String	プロジェクト ID
friendship.id	String	入力 ID
friendship.user_id	String	ユーザー ID
friendship.status	String	状態
friendship.user_id	String	ID
friendship.user	Object	マイ情報
friendship.friend_id	String	友達 ID
friendship.friend	Object	友達情報
friendship.requested_at	String	リクエスト日

失敗

{
    "status": -1,
    "message": "エラーメッセージ"
}

Attribute	Type	Description
code	Int	結果値(1: 成功、失敗時 Error code参照)
error	String	エラー内容

友達承諾

相手から送られてきた友達リクエストを承諾します。承諾後、両ユーザーは友達関係になります。

Request

Method : POST
URI : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/accept

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/accept
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
    "userId": "a1c4aaa2-02f6-40bd-afb4-xxxxxxxxx",
    "friendId": "80803902-8b83-4860-b8a6-xxxxxxx"
}

Header	Type	Required	Description
X-API-KEY	String	O	GamePotで発行する認証キー
X-PROJECT-ID	String	O	ダッシュボードプロジェクト ID

Attribute	Type	Required	Description
userId	String	O	ユーザー ID
friendId	String	O	友達追加 ID

Response

成功

{
   "friendship": {
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxx",
        "id": "5fe78d95-6186-4128-b52a-xxxxxxxxx",
        "status": "accepted",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id": "80803902-8b83-4860-b8a6-xxxxxxxxx",
        "created_at": "2023-01-31T16:13:26-08:00",
        "updated_at": "2023-01-31T16:13:26-08:00",
        "requested_at": "2023-01-31T16:13:26-08:00"
    }
}

Attribute	Type	Description
friendship.project_id	String	プロジェクト ID
friendship.id	String	入力 ID
friendship.user_id	String	ユーザー ID
friendship.status	String	状態
friendship.user_id	String	ID
friendship.friend_id	String	友達 ID
friendship.user	Object	マイ情報
friendship.friend	Object	友達情報
friendship.requested_at	String	リクエスト日

失敗

{
    "status": -1,
    "message": "エラーメッセージ"
}

Attribute	Type	Description
code	Int	結果値(1: 成功、失敗時 Error code参照)
error	String	エラー内容

友達拒否

相手から送られてきた友達リクエストを拒否します。

Request

Method : POST
URI : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/reject

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship/reject
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "userId": "a1c4aaa2-02f6-40bd-afb4-xxxxxxx",
    "friendId": "80803902-8b83-4860-b8a6-xxxxxx"
}

Header	Type	Required	Description
X-API-KEY	String	O	GamePotで発行する認証キー
X-PROJECT-ID	String	O	ダッシュボードプロジェクト ID

Attribute	Type	Required	Description
userId	String	O	ユーザー ID
friendId	String	O	友達追加 ID

Response

成功

{
   "friendship": {
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxx",
        "id": "5fe78d95-6186-4128-b52a-xxxxxxxxx",
        "status": "rejected",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id": "80803902-8b83-4860-b8a6-xxxxxxxxx",
        "created_at": "2023-01-31T16:13:26-08:00",
        "updated_at": "2023-01-31T16:13:26-08:00",
        "requested_at": "2023-01-31T16:13:26-08:00"
    }
}

Attribute	Type	Description
friendship.project_id	String	プロジェクト ID
friendship.id	String	入力 ID
friendship.user_id	String	ID
friendship.friend_id	String	友達 ID
friendship.status	String	状態
friendship.user	Object	マイ情報
friendship.friend	Object	友達情報
friendship.requested_at	String	リクエスト日

失敗

{
    "status": -1,
    "message": "エラーメッセージ"
}

Attribute	Type	Description
code	Int	結果値(1: 成功、失敗時 Error code参照)
error	String	エラー内容

友達をやめる

他のユーザーとの友達関係をやめることができる機能です。友達をやめるには、友達リストからそのユーザーを削除します。やめた友達と再び友達関係を結びたい場合は、新たに友達リクエストを送信する必要があります。

Request

Method : POST
URI : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship

DELETE
url : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "userId": "80803902-8b83-4860-b8a6-xxxxxx",
    "friendId": "a1c4aaa2-02f6-40bd-afb4-xxxxxxx",
}

Header	Type	Required	Description
X-API-KEY	String	O	GamePotで発行する認証キー
X-PROJECT-ID	String	O	ダッシュボードプロジェクト ID

Attribute	Type	Required	Description
userId	String	O	ユーザー ID
friendId	String	O	友達追加 ID

Response

成功

{
   "friendship": {
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxx",
        "id": "5fe78d95-6186-4128-b52a-xxxxxxxxx",
        "status": "deleted",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "created_at": "2023-01-31T16:13:26-08:00",
        "updated_at": "2023-01-31T16:13:26-08:00",
        "requested_at": "2023-01-31T16:13:26-08:00"
    }
}

Attribute	Type	Description
friendship.project_id	String	プロジェクト ID
friendship.id	String	入力 ID
friendship.status	String	状態
friendship.user_id	String	ID
friendship.friend_id	String	友達 ID
friendship.user	Object	マイ情報
friendship.friend	Object	友達情報
friendship.requested_at	String	リクエスト日

失敗

{
    "status": -1,
    "message": "エラーメッセージ"
}

Attribute	Type	Description
code	Int	結果値(1: 成功、失敗時 Error code参照)
error	String	エラー内容

友達リスト

現在の友達リストを表示します。

Request

Method : GET
URI : https://gamepot.apigw.ntruss.com/gpapps/v2/friendships?filter={"status":"accepted","user_id":"2d51cc68-a0d9-xxxxx-xxxx-xxxxxxxxxxxx"}

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/friendship?filter={"status":"accepted","user_id":"2d51cc68-a0d9-xxxxx-xxxx-xxxxxxxxxxxx"}
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'

Header	Type	Required	Description
X-API-KEY	String	O	GamePotで発行する認証キー
X-PROJECT-ID	String	O	ダッシュボードプロジェクト ID

Attribute	Type	Required	Description
filter	String	O	クエリをフィルタ全てのフィールドで検索が可能です。
user_id	String	O	ユーザー ID

** フィルタはコードによって様々な活用が可能です。
Statusコードによって友達リストを検索できます。

"accepted" : 私と友達を承認した友達リスト
"rejected" : 友達の受け入れを拒否したリスト
"requested" : 友達リクエストしたリスト
"pending" : 友達リクエストを受けたリスト

Response

成功

[
    {
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "id":"xxxxxxxxxxxxxxxxxxxx",
        "status": "accepted",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "created_at": "2023-01-31T16:28:00-08:00",
        "updated_at": "2023-01-31T16:28:03-08:00",
        "requested_at": "2023-01-31T16:28:00-08:00"
    },
    {
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "id":"xxxxxxxxxxxxxxxxxxxx",
        "status": "accepted",
        "user_id" : "xxxxxxxxxx",
        "user": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "friend_id" : "xxxxxxxx",
        "friend": {
            "id": "xxxxxxxxxx",
            "nickname": "xxxxxxxxxx"
        },
        "created_at": "2023-01-31T16:28:00-08:00",
        "updated_at": "2023-01-31T16:28:03-08:00",
        "requested_at": "2023-01-31T16:28:00-08:00"
    }
]

Attribute	Type	Description
project_id	String	プロジェクト ID
id	String	固有 ID
status	String	状態
user_id	String	ID
friend_id	String	友達 ID
user	Object	マイ情報
friend	Object	友達情報
created_at	String	作成日
updated_at	String	アップデート日
requested_at	String	リクエスト日

失敗

{
    "status": -1,
    "message": "エラーメッセージ"
}

Attribute	Type	Description
code	Int	結果値(1: 成功、失敗時 Error code参照)
error	String	エラー内容

この記事は役に立ちましたか?

What's Next

事前予約参加を行う

友達管理

タグ

GAMEPOT