Files
zkldi_Tachi/docs/docs/api/routes/games.md
T

1.2 KiB

Game Endpoints

These endpoints cover all games and specific games. For specific playtypes, see Game:Playtype Endpoints.


Retrieve all supported games.

GET /api/v1/games

Parameters

None.

Response

| Property | Type | Description | | :: | :: | :: | | supportedGames | String[] | The list of games this service supports. | | configs | Record<Game, GameConfig> | Contains a mapping of every supported game to its configuration. |

Example

Request

GET /api/v1/games

Response

{
	"supportedGames": ["iidx", "bms"],
	"configs": {
		"iidx": {
			"name": "beatmania IIDX",
			// ...
		},
		"bms": {
			"name": "BMS",
			// ...
		}
	}
}

Retrieve a specific games' configuration.

GET /api/v1/games/:game

Parameters

None.

Response

| Property | Type | Description | | :: | :: | :: | | <body> | GameConfig | The configuration for this game. |

Example

Request

GET /api/v1/games/iidx

Response

{
	"defaultPlaytype": "SP",
	"name": "beatmania IIDX",
	"internalName": "iidx",
	"validPlaytypes": ["SP", "DP"],
}