コマンドと通知サービス API

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

ゲームに直接コマンドを送信するエンドポイント用セキュリティトークンが必要です。

この API は、エンドポイントも提供し、Web クライアントに直接通知を送信することができます

通知

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": ""
}