Inicio de Sesión (Bearer)

POST /signin

Endpoint para obtener un token de acceso a partir de tu correo y contraseña. El accessToken recibido se envía en el header de cada petición posterior como Authorization: Bearer {accessToken}.

¿Es tu método?

Usa esta guía si Blacktrust te entregó un correo y una contraseña. Si te entregó una API Key, tu método es API Key y no necesitas llamar a /signin. Ambos métodos son alternativos: consulta la visión general de Autenticación.

Ejemplo de Petición

cURL

curl -X POST "{BASE_URL}/signin" \
     -H "Content-Type: application/json" \
     -d '{
           "email": "user@client.com",
           "password": "your_secure_password"
         }'

Node.js

const response = await fetch("{BASE_URL}/signin", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "user@client.com",
    password: "your_secure_password",
  }),
});

Respuestas de la API

200 OK

200 OK (Autenticación Exitosa)

Retorna el token de acceso necesario para consumir los demás endpoints de la API.

{
	"success": true,
	"name": "Jane Doe",
	"profile": "blacktrust_tech",
	"photoURL": "",
	"client": "JHR1c0....",
	"clients": [
		"JHR1c0..."
	],
	"accessToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjRiMTFjYjdhYjVmY2JlNDFlOTQ4MDk.....",
	"refreshToken": "AMf-vBz886nr68QaW_XWCZxsW8-tW_VO2V2gu9eH....."
}

401 Unauthorized

401 Unauthorized (Credenciales Inválidas)

Retorna este error si el correo o la contraseña son incorrectos.

{
	"success": false,
	"error": "El nombre de usuario o la contraseña son incorrectos."
}