agones.dev/agones@v1.54.0/sdks/swagger/alpha.swagger.json (about)

     1  {
     2    "swagger": "2.0",
     3    "info": {
     4      "title": "alpha.proto",
     5      "version": "version not set"
     6    },
     7    "tags": [
     8      {
     9        "name": "SDK"
    10      }
    11    ],
    12    "schemes": [
    13      "http"
    14    ],
    15    "consumes": [
    16      "application/json"
    17    ],
    18    "produces": [
    19      "application/json"
    20    ],
    21    "paths": {
    22      "/alpha/player/capacity": {
    23        "get": {
    24          "summary": "Retrieves the current player capacity. This is always accurate from what has been set through this SDK,\neven if the value has yet to be updated on the GameServer status resource.",
    25          "description": "If GameServer.Status.Players.Capacity is set manually through the Kubernetes API, use SDK.GameServer() or SDK.WatchGameServer() instead to view this value.",
    26          "operationId": "GetPlayerCapacity",
    27          "responses": {
    28            "200": {
    29              "description": "A successful response.",
    30              "schema": {
    31                "$ref": "#/definitions/alphaCount"
    32              }
    33            }
    34          },
    35          "tags": [
    36            "SDK"
    37          ]
    38        },
    39        "put": {
    40          "summary": "Update the GameServer.Status.Players.Capacity value with a new capacity.",
    41          "operationId": "SetPlayerCapacity",
    42          "responses": {
    43            "200": {
    44              "description": "A successful response.",
    45              "schema": {
    46                "$ref": "#/definitions/alphaEmpty"
    47              }
    48            }
    49          },
    50          "parameters": [
    51            {
    52              "name": "body",
    53              "description": "Store a count variable.",
    54              "in": "body",
    55              "required": true,
    56              "schema": {
    57                "$ref": "#/definitions/alphaCount"
    58              }
    59            }
    60          ],
    61          "tags": [
    62            "SDK"
    63          ]
    64        }
    65      },
    66      "/alpha/player/connect": {
    67        "post": {
    68          "summary": "PlayerConnect increases the SDK’s stored player count by one, and appends this playerID to GameServer.Status.Players.IDs.",
    69          "description": "GameServer.Status.Players.Count and GameServer.Status.Players.IDs are then set to update the player count and id list a second from now,\nunless there is already an update pending, in which case the update joins that batch operation.\n\nPlayerConnect returns true and adds the playerID to the list of playerIDs if this playerID was not already in the\nlist of connected playerIDs.\n\nIf the playerID exists within the list of connected playerIDs, PlayerConnect will return false, and the list of\nconnected playerIDs will be left unchanged.\n\nAn error will be returned if the playerID was not already in the list of connected playerIDs but the player capacity for\nthe server has been reached. The playerID will not be added to the list of playerIDs.\n\nWarning: Do not use this method if you are manually managing GameServer.Status.Players.IDs and GameServer.Status.Players.Count\nthrough the Kubernetes API, as indeterminate results will occur.",
    70          "operationId": "PlayerConnect",
    71          "responses": {
    72            "200": {
    73              "description": "A successful response.",
    74              "schema": {
    75                "$ref": "#/definitions/alphaBool"
    76              }
    77            }
    78          },
    79          "parameters": [
    80            {
    81              "name": "body",
    82              "description": "The unique identifier for a given player.",
    83              "in": "body",
    84              "required": true,
    85              "schema": {
    86                "$ref": "#/definitions/alphaPlayerID"
    87              }
    88            }
    89          ],
    90          "tags": [
    91            "SDK"
    92          ]
    93        }
    94      },
    95      "/alpha/player/connected": {
    96        "get": {
    97          "summary": "Returns the list of the currently connected player ids. This is always accurate from what has been set through this SDK,\neven if the value has yet to be updated on the GameServer status resource.",
    98          "description": "If GameServer.Status.Players.IDs is set manually through the Kubernetes API, use SDK.GameServer() or SDK.WatchGameServer() instead to view this value.",
    99          "operationId": "GetConnectedPlayers",
   100          "responses": {
   101            "200": {
   102              "description": "A successful response.",
   103              "schema": {
   104                "$ref": "#/definitions/alphaPlayerIDList"
   105              }
   106            }
   107          },
   108          "tags": [
   109            "SDK"
   110          ]
   111        }
   112      },
   113      "/alpha/player/connected/{playerID}": {
   114        "get": {
   115          "summary": "Returns if the playerID is currently connected to the GameServer. This is always accurate from what has been set through this SDK,\neven if the value has yet to be updated on the GameServer status resource.",
   116          "description": "If GameServer.Status.Players.IDs is set manually through the Kubernetes API, use SDK.GameServer() or SDK.WatchGameServer() instead to determine connected status.",
   117          "operationId": "IsPlayerConnected",
   118          "responses": {
   119            "200": {
   120              "description": "A successful response.",
   121              "schema": {
   122                "$ref": "#/definitions/alphaBool"
   123              }
   124            }
   125          },
   126          "parameters": [
   127            {
   128              "name": "playerID",
   129              "in": "path",
   130              "required": true,
   131              "type": "string"
   132            }
   133          ],
   134          "tags": [
   135            "SDK"
   136          ]
   137        }
   138      },
   139      "/alpha/player/count": {
   140        "get": {
   141          "summary": "Retrieves the current player count. This is always accurate from what has been set through this SDK,\neven if the value has yet to be updated on the GameServer status resource.",
   142          "description": "If GameServer.Status.Players.Count is set manually through the Kubernetes API, use SDK.GameServer() or SDK.WatchGameServer() instead to view this value.",
   143          "operationId": "GetPlayerCount",
   144          "responses": {
   145            "200": {
   146              "description": "A successful response.",
   147              "schema": {
   148                "$ref": "#/definitions/alphaCount"
   149              }
   150            }
   151          },
   152          "tags": [
   153            "SDK"
   154          ]
   155        }
   156      },
   157      "/alpha/player/disconnect": {
   158        "post": {
   159          "summary": "Decreases the SDK’s stored player count by one, and removes the playerID from GameServer.Status.Players.IDs.",
   160          "description": "GameServer.Status.Players.Count and GameServer.Status.Players.IDs are then set to update the player count and id list a second from now,\nunless there is already an update pending, in which case the update joins that batch operation.\n\nPlayerDisconnect will return true and remove the supplied playerID from the list of connected playerIDs if the\nplayerID value exists within the list.\n\nIf the playerID was not in the list of connected playerIDs, the call will return false, and the connected playerID list\nwill be left unchanged.\n\nWarning: Do not use this method if you are manually managing GameServer.status.players.IDs and GameServer.status.players.Count\nthrough the Kubernetes API, as indeterminate results will occur.",
   161          "operationId": "PlayerDisconnect",
   162          "responses": {
   163            "200": {
   164              "description": "A successful response.",
   165              "schema": {
   166                "$ref": "#/definitions/alphaBool"
   167              }
   168            }
   169          },
   170          "parameters": [
   171            {
   172              "name": "body",
   173              "description": "The unique identifier for a given player.",
   174              "in": "body",
   175              "required": true,
   176              "schema": {
   177                "$ref": "#/definitions/alphaPlayerID"
   178              }
   179            }
   180          ],
   181          "tags": [
   182            "SDK"
   183          ]
   184        }
   185      }
   186    },
   187    "definitions": {
   188      "alphaBool": {
   189        "type": "object",
   190        "properties": {
   191          "bool": {
   192            "type": "boolean",
   193            "format": "boolean"
   194          }
   195        },
   196        "title": "Store a boolean result"
   197      },
   198      "alphaCount": {
   199        "type": "object",
   200        "properties": {
   201          "count": {
   202            "type": "string",
   203            "format": "int64"
   204          }
   205        },
   206        "description": "Store a count variable."
   207      },
   208      "alphaEmpty": {
   209        "type": "object",
   210        "title": "I am Empty"
   211      },
   212      "alphaPlayerID": {
   213        "type": "object",
   214        "properties": {
   215          "playerID": {
   216            "type": "string"
   217          }
   218        },
   219        "description": "The unique identifier for a given player."
   220      },
   221      "alphaPlayerIDList": {
   222        "type": "object",
   223        "properties": {
   224          "list": {
   225            "type": "array",
   226            "items": {
   227              "type": "string"
   228            }
   229          }
   230        },
   231        "title": "List of Player IDs"
   232      }
   233    }
   234  }