API Reference
This section provides details on the public and private API endpoints available for interacting with the jailbreakme.xyz platform. The endpoints allow users to retrieve tournament data and manage conversations, with some routes requiring authentication for Pro Users.
Tournaments API
Base URL: /api/json/v1/tournament
Endpoints
GET /
- Fetch All Tournaments (Public)
/
- Fetch All Tournaments (Public)Retrieves a list of all tournaments with basic details.
Response:
Errors:
400 Bad Request
: If there is an issue retrieving tournaments.
GET /:id
- Fetch Tournament by ID (Public)
/:id
- Fetch Tournament by ID (Public)Retrieves details of a specific tournament by its ID.
Parameters:
id
(Path Parameter): The ID of the tournament to retrieve.
Response:
Errors:
400 Bad Request
: If the tournament ID is invalid or the tournament cannot be retrieved.
POST /new-
tournament - Create a New Tournament (Private)
/new-
tournament - Create a New Tournament (Private)Allows Pro Users to create a new tournament.
Headers:
Authorization
: Bearer token for authentication.
Body:
Response:
Errors:
400 Bad Request
: If required fields are missing or invalid.
Conversations API
Base URL: /api/json/v1/conversations
Endpoints
GET /
- Fetch User Conversations (Private)
/
- Fetch User Conversations (Private)Retrieves all conversations associated with the authenticated user.
Headers:
Authorization
: Bearer token for authentication.
Response:
Errors:
400 Bad Request
: If there is an issue retrieving conversations.401 Unauthorized
: If the user is not authenticated.
GET /tournament/:tournament
- Fetch Conversations by Tournament (Private)
/tournament/:tournament
- Fetch Conversations by Tournament (Private)Retrieves conversations associated with a specific tournament for the authenticated user.
Headers:
Authorization
: Bearer token for authentication.
Parameters:
tournament
(Path Parameter): The ID of the tournament.
Response:
Errors:
400 Bad Request
: If the tournament ID is invalid or no conversations are found.401 Unauthorized
: If the user is not authenticated.
Authentication
The private endpoints require a valid API token in the api-key header. Tokens are issued upon user authentication and must be included in requests to restricted routes.
Example Header:
This API allows public users to explore tournaments while providing authenticated users additional functionality to manage their progress.
Last updated