Autenticación

API Keys

Para integración backend-to-backend, usa API keys. Se generan desde el dashboard en Settings → API Keys o vía API. Genera tu primera API key desde el dashboard en Settings → API Keys. También puedes crearlas vía API si ya tienes una key:

curl -X POST https://api.example.com/api/v1/api-keys \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "produccion-backend"}'

Respuesta:

{
  "id": "uuid",
  "name": "produccion-backend",
  "keyPrefix": "sk_live_abc1",
  "keyHint": "xy9z",
  "rawKey": "sk_live_abc123...fullkey",
  "createdAt": "2024-01-15T10:00:00Z"
}

rawKey se muestra una sola vez. Guárdalo en un vault o variable de entorno segura.

Usar la API key

Pasa la key en el header Authorization:

curl https://api.example.com/api/v1/tenants \
  -H "Authorization: Bearer sk_live_abc123...fullkey"

El sistema detecta automáticamente que es una API key por el prefijo sk_.

Revocar una key

curl -X DELETE https://api.example.com/api/v1/api-keys/{keyId} \
  -H "Authorization: Bearer sk_live_..."

La key deja de funcionar inmediatamente. No se puede deshacer.

Seguridad

Las keys se hashean con SHA-256 antes de almacenarse. Nunca guardamos el texto plano.
Cada key está asociada a una cuenta (accountId). Solo puede operar sobre los tenants de esa cuenta.
Usa keys distintas por entorno (producción, staging, CI/CD) para poder revocar granularmente.

Empezar

Flujos principales

Referencia

Autenticación

API Keys

Usar la API key

Revocar una key

Seguridad

​API Keys

​Usar la API key

​Revocar una key

​Seguridad

API Keys

Usar la API key

Revocar una key

Seguridad