个人资料 API 同步

請根據社區檔案類型在檔案 API 整合菜單中設置 API。

當僅使用社區檔案時，註冊 基本檔案圖片 API
當連結遊戲檔案時，註冊 遊戲檔案 API

預設個人檔案圖片¶

個人檔案圖片 API 用於更改預設的社群個人檔案圖片。

API 會透過 批次程式在 02:00 (KST) 進行資訊檢索和更新（適用於生產和沙盒環境）。
圖片大小必須至少為 160 x 160 像素，並且預設會應用圓角和邊框輪廓，因此請創建正方形比例的圖片。

請求 URL¶

商業網址	https://${URL}/profile/get-image-list
測試網址	https://${URL}/profile/get-image-list

請求主體¶

+ 類型 : post
+ 參數
    - 無參數

回應主體¶

+ 類型 : 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，以便用戶在社區和遊戲中擁有相同的個人資料。

當用戶登錄社區時，遊戲資料會被更新。

請求網址¶

商業網址	https://${URL}/profile/get-player
測試網址	https://${URL}/profile/get-player

請求主體¶

+ 類型 : post
+ 參數

欄位名稱	描述	類型	必填
pid	使用者的 PlayerID	字串	是

樣本¶

{
    "pid" : "20000010000"
}

回應主體¶

+ 類型 : json
+ 參數

名稱	描述	類型	值
result	結果	JSON 物件
result.code	結果代碼 (100: 成功)	整數	100
result.msg	結果訊息	字串
params	參數	JSON 物件
params.pid	使用者的 PlayerID	字串	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"
    }
}