Autenticación
La API Universal soporta dos métodos de autenticación alternativos. Tu integración usa uno solo: el que Blacktrust define contigo a nivel de contrato. Junto con tu contrato recibes únicamente las credenciales de ese método.
En cada petición envía un solo mecanismo de autenticación: el header x-api-key o el header Authorization: Bearer. No es necesario (ni recomendable) combinarlos.
¿Cuál es el mío?
| Si Blacktrust te entregó… | Tu método es… | Qué envías en cada petición | Guía |
|---|---|---|---|
| Una API Key | API Key | x-api-key: {apiKey} | API Key |
| Un correo electrónico y una contraseña | Usuario y contraseña (token Bearer) | Authorization: Bearer {accessToken} | Inicio de Sesión |
Si no estás seguro de cuál te corresponde, consúltalo con tu contacto comercial de Blacktrust.
Cómo funciona cada método
- API Key
- Usuario y contraseña (Bearer)
No requiere un paso previo: envía tu apiKey en el header x-api-key desde la primera petición.
curl -X GET "{BASE_URL}/candidate-requests/{uuid}" \
-H "x-api-key: {apiKey}" \
-H "Content-Type: application/json"
Primero obtén un token con POST /signin y después envíalo en el header Authorization de cada petición.
# 1. Obtener el token
curl -X POST "{BASE_URL}/signin" \
-H "Content-Type: application/json" \
-d '{"email": "user@client.com", "password": "your_secure_password"}'
# 2. Usar el accessToken recibido
curl -X GET "{BASE_URL}/candidate-requests/{uuid}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json"
Cambiar de método
El método de autenticación se configura a nivel de contrato. Si necesitas cambiarlo, o rotar tus credenciales, solicítalo a través de tu contacto comercial.