Guías

Autenticación

Cómo autenticarte en la API de Inspow con un token JWT Bearer o con una API Key.

La API de Inspow acepta dos credenciales:

Token JWT (esquema Bearer) de un Usuario, obtenido con su correo y contraseña.
API Key de tu Organización, para integraciones servidor-a-servidor (ver API Keys).

1. Obtener un token

Envía las credenciales al endpoint de login. Si el correo existe en varias organizaciones, indica cuál con tenantSlug:

curl -X POST https://api.inspow.tech/api/v1/access-control/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "tu@correo.com", "password": "••••••••", "tenantSlug": "mi-organizacion" }'

Como todas las respuestas de la API, viene envuelta en { "data": …, "meta": … }. El token está en data.token (junto con los datos del Usuario en data.user).

Si el Usuario tiene verificación en dos pasos

Si la cuenta tiene 2FA activa, el login no devuelve token, sino requires2fa: true y un tempToken (válido unos 5 minutos). Complétalo con el código de la app de autenticación:

curl -X POST https://api.inspow.tech/api/v1/access-control/auth/2fa/verify \
  -H "Content-Type: application/json" \
  -d '{ "tempToken": "<TEMP_TOKEN>", "code": "123456" }'

Para usar un código de respaldo, envía además "isBackupCode": true. Para integraciones automáticas, usa mejor una API Key.

2. Usar el token

Incluye el token en la cabecera Authorization de cada petición protegida:

curl https://api.inspow.tech/api/v1/access-control/auth/user/me \
  -H "Authorization: Bearer <TU_TOKEN>"

API Keys

Para integraciones servidor-a-servidor usa una API Key de tu Organización, con un alcance (scope) limitado, en lugar del token de un Usuario. Se envía en X-API-Key: ak_… o en Authorization: Bearer ak_… / Authorization: ApiKey ak_…. Ver API Keys.