Obtener token de autenticación

POST

{{BASE_URL}}/api/v1/auth/api-token

Endpoint para que aplicaciones externas obtengan un token de autenticación API.

Permite a aplicaciones externas autenticarse ante DIMAIL y obtener un token de acceso para consumir los endpoints de integración de la API.

El token generado debe enviarse en las solicitudes posteriores mediante el encabezado Authorization, utilizando el esquema Bearer.

Solicitud

Autorización

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200OK

application/json

Body

🟠400Bad Request

🟠401Unauthorized

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --globoff '{{BASE_URL}}/api/v1/auth/api-token' \
--header 'Content-Type: application/json' \
--data '{
    "clientId": "cli_xxxxxxxxx",
    "clientSecret": "xxxxxxxxx"
}'

Ejemplo de Respuesta

200 - Éxito

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "tokenType": "Bearer",
    "expiresIn": 86400
  },
  "message": "",
  "layer": "",
  "statusCode": 200
}

Modificado en 2026-08-19 03:07:44

API DIMAIL

Descargar Certificado