コンテンツにスキップ

プロフィールAPI同期

コミュニティプロファイルタイプに応じて、プロファイルAPI統合メニューでAPIを設定してください。

コミュニティプロファイルのみを使用する場合、**基本プロファイル画像API**を登録します
ゲームプロファイルをリンクする場合、**ゲームプロファイルAPI**を登録します

デフォルトプロフィール画像¶

プロフィール画像APIは、デフォルトのコミュニティプロフィール画像を変更するために使用されます。

APIは情報を取得し、バッチプログラムを介して02:00 (KST)に更新が行われます（本番環境とサンドボックス環境の両方に適用されます）。
サイズは少なくとも160 x 160pxでなければならず、角の丸みと境界線はデフォルトで適用されるため、正方形の比率で画像を作成してください。

リクエストURL¶

商業用URL	https://${URL}/profile/get-image-list
テストURL	https://${URL}/profile/get-image-list

リクエスト BODY¶

+ 種類 : post
+ パラメータ
    - パラメータなし

レスポンス BODY¶

+ タイプ : json
+ パラメータ

名前	説明	タイプ	値
result	結果	JSONオブジェクト
result.code	結果コード (100 : 成功)	整数	100
result.msg	結果メッセージ	文字列
params	パラメータ	JSONオブジェクト
params.total	リストの数	int	10
params.list	リスト（画像URL）	文字列配列	\["https://test-img.co.kr/profile1.jpg","https://test-img.co.kr/profile2.jpg" ... \]

戻りコード¶

+ 100 \- 成功 \- 成功（成功は常に100で示されることを確認してください。）

応答サンプル¶

{
    "result": {
        "code": 100,
        "msg": "success"
    },
    "params":{
        "total": 10,
        "list":[
                "https://test-img.co.kr/profile1.jpg",
                "https://test-img.co.kr/profile2.jpg",
                "https://test-img.co.kr/profile3.jpg",
                ……
                "https://test-img.co.kr/profile10.jpg"
        ]
    }
}

ゲームプロファイルAPI¶

管理者は、ユーザーがコミュニティとゲームの両方で同じプロフィールを持つようにAPIを設定できます。

ユーザーがコミュニティにログインすると、ゲームプロフィールが更新されます。

リクエストURL¶

商用URL	https://${URL}/profile/get-player
テストURL	https://${URL}/profile/get-player

リクエストボディ¶

+ タイプ : post
+ パラメータ

フィールド名	説明	タイプ	必須
pid	ユーザーのプレイヤーID	文字列	Y

サンプル¶

{
    "pid" : "20000010000"
}

レスポンスボディ¶

+ タイプ : json
+ パラメータ

名前	説明	タイプ	値
result	結果	JSONオブジェクト
result.code	結果コード (100: 成功)	整数	100
result.msg	結果メッセージ	文字列
params	パラメータ	JSONオブジェクト
params.pid	ユーザーのプレイヤーID	文字列	20000010000
params.nickname	ユーザーのニックネーム	文字列	Tom
params.p_image	ユーザーのプロフィール画像URL	文字列	https://test-img.co.kr/profile1.jpg

戻りコード¶

+ 100 - 成功 - 成功（成功は常に100で示されることを確認してください。）
+ 101 - 無効なリクエスト - 必要なキー値が欠けている場合
+ 102 - ユーザーが存在しない - ユーザーが存在しない場合

レスポンスサンプル¶

{
    "result": {
        "code": 100,
        "msg": "success"
    },
    "params": {
        "pid": "20000010000",
        "nickname": "Tom",
        "p_image": "https://test-img.co.kr/profile1.jpg"
    }
}