Webgateway サービス API

Webgateway サービスはサードパーティのアプリケーション用の HTTP API を提供し、Web サイトからゲームへのコマンド送信や視聴者への通知を可能にします。

API を使用するためにセキュリティトークンが必要です。トークンは 「secret」 ヘッダーに渡されます。

通知

POST /notifications

通知は即座に送信されます。ストリームには同期しません。このエンドポイントから送信された通知は、sessionid が 『web』 に設定されています。

リクエストヘッダ:
  • secret – サービスへのリクエスト送信には、セキュリティトークンが必要です。
リクエスト JSON オブジェクト:
 
  • notifications[] (object) – 通知オブジェクトのリスト
  • notifications[].id (string) – 通知 ID。
  • notifications[].data (string) – base 64 でエンコードされた通知のペイロード。

クエリ例 :

{
  "notifications": [
    {
      "id": "",
      "data": ""
    }
  ]
}

コマンド

POST /commands/game

コマンドは、key-value のペアで構成されます。ゲームはキーを使用してコマンドのタイプを識別します。値は、ゲームが解析できる文字列です。

リクエストヘッダ:
  • secret – サービスへのリクエスト送信には、セキュリティトークンが必要です。
リクエスト JSON オブジェクト:
 
  • key (string) – ゲームがコマンドのタイプを認識するための ID。
  • value (string) – ゲームがコマンドにパースするための値。

クエリ例 :

{
  "key": "",
  "value": ""
}

イベント

POST /events

エンドポイントを使って大量のイベントをゲームに送ることができます。イベントを送信する前にバックエンドで特別な作業をする必要がある場合に、クライアントから直接イベントを送信する代わりに行う方法です。最大バッチサイズが 2000 の場合、エンドポイントはコード 413 を返します。

リクエストヘッダ:
  • secret – サービスへのリクエスト送信には、セキュリティトークンが必要です。
リクエスト JSON オブジェクト:
 
  • events[] (object) – イベント一覧。
  • events[].key[] (string) – 文字列配列の形式のイベントキー。
  • events[].value (undefined) – ゲームがコマンドにパースするための値。

クエリ例 :

{
  "events": [
    {
      "key": [
        "cheer"
      ],
      "value": "Porthos"
    },
    {
      "key": [
        "cheer"
      ],
      "value": "Porthos"
    },
    {
      "key": [
        "cheer"
      ],
      "value": "Aramis"
    },
    {
      "key": [
        "cheer"
      ],
      "value": "Athos"
    }
  ]
}