Tutorials

New Recruit has many features, some can be quite complex, especially the Tournament Organiser tool

API documentation

Systems API Documentation

This API returns the list of available game systems, including their internal IDs and names. Use these IDs when querying other endpoints that require a id_game_system parameter.

Authentication

All requests require authentication via HTTP headers.
  • NR-Login: Your username
  • NR-Password: Your password

If authentication fails, you will receive:
{ "message": "Wrong username/password, please contact NR if you need to access this API" }

Endpoint

POST https://www.newrecruit.eu/api/systems

Request Body

No request body is required for this endpoint.

Example Request

POST /api/systems HTTP/1.1
Host: www.newrecruit.eu
Content-Type: application/json
NR-Login: myuser
NR-Password: mypassword
  

Response

  • On success:
    Returns an array of objects, each with:
    • id: Unique system ID (number)
    • name: Name of the game system (string)
  • On error:
    { "error": "Incorrect input" }

Notes

  • This endpoint does not require any request body.
  • Use the id field when specifying a game system in other API requests (e.g., /api/tournaments).
  • The API logs the user and date of each request internally.

Error Handling

If authentication fails, you will receive:
{ "message": "Wrong username/password, please contact NR if you need to access this API" }

On any other error, you may receive:
{ "error": "Incorrect input" }

Internal errors are logged.

Contact

If you require access or encounter authentication issues, please contact the NR team.