跳轉至

社区

預設個人資料圖片

個人資料圖片 API 用於更改預設的社區個人資料圖片。

該API檢索信息並更新 在02:00(KST)通過批處理程序進行(適用於生產和沙盒環境)。

大小必須至少為 160 x 160 像素,並且默認情況下會應用圓角和邊框輪廓,因此請創建正方形比例的圖像。

  • 請求網址
商業網址 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,以便用戶在社區和遊戲中擁有相同的個人資料。

當用戶登錄社區時,遊戲檔案會被更新。

  • 請求 URL
商業網址 https://${URL}/profile/get-player
測試網址 https://${URL}/profile/get-player
  • 請求主體
    • 類型 : post
    • 參數
欄位名稱 描述 類型 必需
pid 使用者的玩家ID 字串
  • 範例
{
    "pid" : "20000010000"
}
  • 回應主體
    • 類型 : json
    • 參數
名稱 描述 類型
result 結果 JSON 物件
result.code 結果代碼 (100: 成功) 整數 100
result.msg 結果訊息 字串
params 參數 JSON 物件
params.pid 使用者的玩家ID 字串 20000010000
params.nickname 使用者的暱稱 字串 Tom
params.p_image 使用者的個人資料圖片網址 字串 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"
    }
}