Autenticación

Token JWT a partir del usuario o de la API key. Las credenciales son de cada entorno.

POST/api/authentication/subscription

Generar un token (JWT)

Devuelve un JWT para Authorization: Bearer, a partir del usuario y la contraseña, o de la API key, del mismo entorno. Con la API key también puedes llamar directamente con la cabecera apikey.

Autenticación. Sin autenticación.

Cuerpo application/json

  • apiKeystring

    Alternativa a email y password: tu API key de este entorno.

  • emailstring

    Correo de tu usuario de TRATO en este entorno.

  • passwordstring

    Contraseña de tu usuario de TRATO en este entorno.

Respuestas

  • 200object
    Campos de la respuesta
    • jwtstringobligatorio

      JWT que se envía en Authorization: Bearer <jwt>.

    • successbooleanobligatorio
    • ttlnumberobligatorio

      Validez del token en segundos.

  • 400Petición no válida: parámetros, contrato inexistente o en un estado que no lo permite.

Petición

POST
/api/authentication/subscription
curl -X POST "https://enterprise-stage.api.trato.io/api/authentication/subscription" \
  -H "Content-Type: application/json" \
  -d '{
  "apiKey": "string",
  "email": "integracion@example.com",
  "password": "********"
}'

Respuesta

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "success": true,
  "ttl": 300
}
POST/api/authentication/token

Generar un token (JWT)

Devuelve un JWT para Authorization: Bearer, a partir del usuario y la contraseña, o de la API key, del mismo entorno. Con la API key también puedes llamar directamente con la cabecera apikey.

Autenticación. Sin autenticación.

Cuerpo application/json

  • apiKeystring

    Alternativa a email y password: tu API key de este entorno.

  • emailstring

    Correo de tu usuario de TRATO en este entorno.

  • passwordstring

    Contraseña de tu usuario de TRATO en este entorno.

Respuestas

  • 200object
    Campos de la respuesta
    • jwtstringobligatorio

      JWT que se envía en Authorization: Bearer <jwt>.

    • successbooleanobligatorio
    • ttlnumberobligatorio

      Validez del token en segundos.

  • 400Petición no válida: parámetros, contrato inexistente o en un estado que no lo permite.

Petición

POST
/api/authentication/token
curl -X POST "https://enterprise-stage.api.trato.io/api/authentication/token" \
  -H "Content-Type: application/json" \
  -d '{
  "apiKey": "string",
  "email": "integracion@example.com",
  "password": "********"
}'

Respuesta

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "success": true,
  "ttl": 300
}