Safira Paydocs

Generar token de acceso JWT

POST /api/auth/token

Autenticarse utilizando un certificado de cliente X.509 + credenciales OAuth 2.0 (clientId/clientSecret) y recibir un token JWT válido por 30 minutos (1800 segundos).

Headers

HeaderTipoRequeridoDescripción
X-SSL-Client-CertstringCertificado PEM del cliente codificado en URL (header estándar de NGINX)

Cuerpo de la solicitud

CampoTipoRequeridoDescripción
clientIdstringClient ID de OAuth 2.0 obtenido en la creación de credenciales
clientSecretstringClient secret de OAuth 2.0 (8-64 caracteres)
{
  "clientId": "account-93-550e8400",
  "clientSecret": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

Respuesta (201)

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 1800
}

Errores

EstadoDescripción
400Solicitud inválida o certificado faltante en el header X-SSL-Client-Cert
401Credenciales inválidas o certificado inválido

El certificado X.509 debe enviarse codificado en URL en el header X-SSL-Client-Cert. El certificado debe estar previamente vinculado a su cuenta.

En esta página