Welcome to the EdGamers API documentation. This API allows developers to integrate their games seamlessly with our platform. Below you will find detailed information about the available endpoints and how to use them.
All API requests must be authenticated using an API key. You can obtain your API key from the EdGamers developer portal.
Authorization: Bearer YOUR_API_KEYRetrieve a list of all available games on the EdGamers platform.
GET /games[
{
"id": "game_1",
"title": "Bouncy Blob Adventure",
"url": "https://create-games-edgamers.s3.amazonaws.com/game_1.html"
},
{
"id": "game_2",
"title": "Elemental Escape",
"url": "https://create-games-edgamers.s3.amazonaws.com/game_2.html"
}
]Retrieve detailed information about a specific game.
GET /games/{game_id}{
"game_id": "The unique identifier of the game."
}{
"id": "game_1",
"title": "Bouncy Blob Adventure",
"description": "A fun and challenging platformer game.",
"url": "https://create-games-edgamers.s3.amazonaws.com/game_1.html",
"developer": "Jane Doe",
"release_date": "2024-06-15"
}Upload and create a new game on the EdGamers platform.
POST /games{
"title": "The title of the game.",
"description": "A brief description of the game.",
"file": "The game file (HTML, CSS, JS) to upload."
}{
"id": "game_3",
"title": "New Game Title",
"url": "https://create-games-edgamers.s3.amazonaws.com/game_3.html"
}Update the details of an existing game.
PUT /games/{game_id}{
"game_id": "The unique identifier of the game."
}{
"title": "The new title of the game.",
"description": "The new description of the game."
}{
"id": "game_1",
"title": "Updated Game Title",
"description": "Updated description of the game."
}Remove a game from the EdGamers platform.
DELETE /games/{game_id}{
"game_id": "The unique identifier of the game."
}{
"message": "Game deleted successfully."
}{
"400": "Bad Request - The request could not be understood or was missing required parameters.",
"401": "Unauthorized - Authentication failed or user does not have permissions for the requested operation.",
"404": "Not Found - The requested resource could not be found.",
"500": "Internal Server Error - An error occurred on the server."
}