キャラクター照会

Prev Next

当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。

ゲーム内のプレイヤーIDを照会します。

要請

GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/player/{playerID}
項目 タイプ 必須かどうか 説明 備考
projectId String O GamePot SDKの projectId
playerID String O GamePot SDKのプレイヤーID

要請 Header

Header名 必須かどうか 説明
x-api-key O GamePotで発行する認証key
accept-language X 使用言語

応答

フィールド名 タイプ 説明
status Int 結果値 (1: 成功)
id String ユーザーID
player_id String プレイヤーID
server_id String サーバID
name String プレイヤー名
level String プレーヤー·レベル
userdata String 登録したUserdata
ip String プレイヤーip
createdAt String プレイヤー生成日
updatedAt String プレイヤー更新日
user_id String Gamepot UID

例示

要請例


curl --request GET \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/player/dodo  \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'

応答例

{
  "status": 1,
  "result": {
    "id": "xxxxxxxxxxxxxxx",
    "player_id": "テストID",
    "server_id": "テストサーバー",
    "name": "テスト名",
    "level": "12",
    "userdata": "dododo",
    "ip": "xxx.xxx.xxx.xxx",
    "createdAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "updatedAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "user_id": "xxxxxxxxxxxxxxx"
  }
}

エラーコード

Gamepot Open APIリクエスト時に発生する共通エラーコードです。

parameter 説明
status エラーコード(1: 成功、失敗時Error code参考)
message エラー詳細説明
エラーコード 説明
-1 ダッシュボードにないkeyを使用した場合
-2 ダッシュボードのkeyとheaderのkeyが異なる場合
-3 ダッシュボードで削除したkeyを使用した場合
-4 ダッシュボードで未使用に処理されたkeyを使用した場合
-5 keyが切れた場合
-6 プロジェクトIDがない場合 
{
  "status": -6,
  "message": "projectId was wrong."
}