コンテンツにスキップ

コミュニティ

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

プロフィール画像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 - SUCCESS - 成功(成功は常に100で示されることを確認してください。)
    • 101 - INVALID_REQUEST - 必要なキー値が欠落している場合
    • 102 - NOT_EXIST_USER - ユーザーが存在しない場合
  • レスポンスサンプル

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