Copy page

Autenticación

Autenticación por cookies

El método más simple. Al iniciar sesión la API establece cookies de sesión que tu cliente HTTP envía automáticamente en cada petición siguiente — sin que necesites manejar tokens.

---

Paso 1: Codifica tus credenciales

Combina tu email y credencial separados por : y codifica en Base64. Puedes usar tu contraseña o tu api_token:

Code
# Con contraseña
echo -n "[email protected]:DummyPass1@" | base64
# Resultado: bWlAZW1haWwuY29tOkR1bW15UGFzczFA

# Con api_token
echo -n "[email protected]:9d459233974f1500aa79d94f550c2694" | base64
# Resultado: bWlAZW1haWwuY29tOjlkNDU5MjMzOTc0ZjE1MDBhYTc5ZDk0ZjU1MGMyNjk0

---

Paso 2: Inicia sesión

Ejemplo de petición:

Code
curl --location --request POST 'https://nominapp-api-stage.herokuapp.com/v1/sessions' \
--header 'Authorization: Basic bWlAZW1haWwuY29tOkR1bW15UGFzczFA' \
--header 'Accept: application/json'

Ejemplo de respuesta:

Code
{
  "data": {
    "user": {
      "id": "3a4b8cc7-fb8c-4eac-94fb-c0b6b39bbcf1",
      "email": "[email protected]",
      "role": "admin",
      "company_id": "32668bfe-78a4-498d-a62b-3e8c1693d723"
    },
    "created_at": 1712803200000,
    "is_new_user": false,
    "expires": 1712889600
  }
}

La respuesta no incluye tokens en el body, la sesión se maneja a través de las cookies que la API establece automáticamente en los headers de respuesta.

Cookies que se crean

Cookie	Descripción	Duración
token	Token de sesión	4 horas
refresh_token	Renueva la sesión automáticamente	12 horas

Las cookies son HttpOnly (no accesibles desde JavaScript), Secure (solo HTTPS) y SameSite=None (permiten peticiones cross-origin desde apps React, Angular, etc.).

---

Paso 3: Haz tus peticiones

En navegadores y Postman las cookies se envían automáticamente, no necesitas configurar nada adicional. En curl debes pasarlas manualmente:

Code
curl --location 'https://nominapp-api-stage.herokuapp.com/v1/economic_sectors' \
--header 'Accept: application/json' \
--cookie 'token=TU_TOKEN; refresh_token=TU_REFRESH_TOKEN'

---

Renovación de la sesión

El token expira en 4 horas, pero la API lo renueva automáticamente usando el refresh_token. La sesión máxima es de 12 horas; después debes hacer login de nuevo.

---

Errores comunes

401 — No autorizado

Causa	Solución
La sesión expiró (12 horas)	Vuelve al Paso 2 para iniciar sesión de nuevo
Las cookies no se están enviando	Verifica que tu cliente HTTP soporte cookies
Dominio no autorizado	Contacta al equipo de Aleluya o usa Bearer token