商品配布 API

Webショップで購入した商品のユーザー情報を照会します。コンソールでゲームサーバー、チャンネル、キャラクターを選択し、製品配信のための適切なAPIを作成して登録します。

メニュー: コミュニティ & ウェブショップ > ウェブショップ > ウェブショップ設定 > アイテム配布

Note

配送方法に従ってAPIを作成します。以下のリクエスト例で詳細を確認してください。

ゲームサーバー（サーバー、チャンネル、キャラクター）リストを確認する¶

リクエストURL¶

環境	URL
本番	https://{URL}/webstore-profile
サンドボックス	https://{URL}/webstore-profile
テスト	https://{URL}/webstore-profile

リクエストヘッダー¶

タイプ	値
Http メソッド	POST
コンテンツタイプ	application/json

リクエストパラメータ¶

フィールド	タイプ	必須	説明
cs_code	文字列	O	ユーザー識別子のユニークな値

応答データ¶

フィールド	タイプ	必須	説明
result_code	整数	O	結果コード
result_message	文字列	O	結果メッセージ
cs_code	文字列	O	ユーザー識別子
data	配列	O	サーバーリスト
data.server_id	文字列	O	ユニークサーバー識別子
data.server_name	文字列	O	サーバー名
data.channels	配列	O	サーバーに含まれるチャンネル
data.channels.channel_id	文字列	O	ユニークチャンネル識別子（チャンネルが使用されていない場合、応答値は“0”です。）
data.channels.channel_name	文字列	O	チャンネル名（チャンネルが使用されていない場合、応答値は“-”です。）
data.channels.characters	配列	O	チャンネルに含まれるキャラクターのリスト（キャラクターが使用されていない場合、応答値は[]です。）
data.channels.characters.character_id	文字列	O キャラクターを使用する場合	ユニークキャラクター識別子
data.channels.characters.character_name	文字列	O キャラクターを使用する場合	キャラクター名
data.channels.characters.character_level	文字列	O キャラクターを使用する場合	キャラクターレベル（キャラクターレベルがない場合、応答値は“-”です。）

結果コード¶

コード	説明
200	成功
500	サーバーエラー
-	ユーザー情報なし

リクエストの例¶

# Request Parameters
{
  cs_code: "c_1234123"
}

# Response
{
  "result_code": 200,
  "result_message": "success",
  "cs_code": "c_123412341234",
  "data": [
   {
    # Server, Channel, Character
    "server_id": "1",
    "server_name": "Server 1",
    "channels": [{
      "channel_id": "1",
      "channel_name": "Channel 1",
      "characters": [{
        "character_id": "A",
        "character_name": "Character A",
        "character_level": "99",
      },
      {
        "character_id": "B",
        "character_name": "Character B",
        "character_level": "10",
      }]
    }]
  },
  {
    # Server, Character
    "server_id": "2",
    "server_name": "Server 2",
    "channels": [{
      "channel_id": "0",
      "channel_name": "-",
      "characters": [{
        "character_id": "C",
        "character_name": "Character C",
        "character_level": "11",
      },
      {
        "character_id": "D",
        "character_name": "Character E",
        "character_level": "12",
      }]
    }]
  },
  {
    # Server, Channel
    "server_id": "3",
    "server_name": "Server 3",
    "channels": [{
      "channel_id": "2",
      "channel_name": "Channel 2",
      "characters": []
    }]
  },
  {
    # Server
    "server_id": "4",
    "server_name": "Server 4",
    "channels": [{
      "channel_id": "0",
      "channel_name": "-",
      "characters": []
    }]
  }
 ]} 
}