API Reference

Login

Logs in an agent by providing username and password

API requests to MPS are secured through an authentication system based on login and password, along with the use of a JWT token to protect API access after authentication. Any request sent without proper authentication will be rejected.

Authentication Process

  1. Authentication via login and password:

    • Users must first authenticate through the dedicated authentication endpoint (/login) by sending their login and password in a POST request with JSON format.
    • If authentication is successful, a JWT token (JSON Web Token) is returned in the response.
    • This token must then be included in the headers of all subsequent requests to access protected API resources.
  2. Using the JWT token for authenticated requests:

    • Once the user receives their JWT token, it must be provided in the HTTP Authorization header for every protected request.
    • The Authorization header must have the following format:
Authorization: Bearer <token>

Security Requirements

  • If a request is sent without the JWT token in the Authorization header, or if the token is invalid or expired, the API will return a 401 Unauthorized error.

JWT Token Management

  • Token expiration: JWT tokens have a limited lifespan. Once expired, a new token must be obtained by re-authenticating with credentials via the /login endpoint.
  • Confidentiality: The JWT token must be kept secret and secure at all times.

This endpoint doesn't need a bearer authorization token (JWT), but every other need one.

This is because this endpoint will return a JWT token, to provide you access to all of the functionalities of the API.



Language