Crear API key de empresa

Referencia tecnica del endpoint Crear API key de empresa.

Quickstart Auth Errores

Endpoint

Metodo: POST
Path: /api/v1/apikeys

Request

nombre string requerido
descripcion string opcional
rate_limit_per_minute int opcional
rate_limit_per_hour int opcional
rate_limit_unlimited bool opcional
idEmpresa int opcional si el JWT tiene acceso a mas de una empresa

Seguridad

La API key completa se muestra una unica vez en esta respuesta.
El sistema guarda solo hash seguro y prefijo identificable.
Los limites se aplican solo a requests autenticados por API key y no cambian el flujo legacy.
Las empresas Sandbox generan claves con prefijo bt_test_....
Las empresas de Produccion generan claves con prefijo bt_live_....

Request

curl -X POST '$BASE/api/v1/apikeys' \
  -H 'Authorization: Bearer <JWT>' \
  -H 'Content-Type: application/json' \
  -d '{
    "nombre": "Integrador POS principal",
    "descripcion": "Canal de emision productivo",
    "rate_limit_per_minute": 180,
    "rate_limit_per_hour": 3600
  }'

curl -X POST '$BASE/api/v1/apikeys' \
  -H 'Authorization: Bearer <JWT>' \
  -H 'Content-Type: application/json' \
  -d '{
    "nombre": "Integrador POS principal",
    "descripcion": "Canal de emision productivo",
    "rate_limit_per_minute": 180,
    "rate_limit_per_hour": 3600
  }'

Response

{
  "Res": "OK",
  "Data": {
    "id": 10,
    "nombre": "Integrador POS principal",
    "descripcion": "Canal de emision productivo",
    "prefijo": "bt_live_abcd1234",
    "estado": "activa",
    "activa": true,
    "fechaAlta": "2026-04-03 11:20:00",
    "fechaRevocacion": null,
    "ultimoUso": null,
    "rateLimitPerMinute": 180,
    "rateLimitPerHour": 3600,
    "rateLimitUnlimited": false,
    "maskedKey": "bt_live_abcd1234...e8d2"
  },
  "ApiKey": "bt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "Message": "Guarda esta API key ahora. Luego no podra volver a visualizarse."
}

{
  "Res": "OK",
  "Data": {
    "id": 10,
    "nombre": "Integrador POS principal",
    "descripcion": "Canal de emision productivo",
    "prefijo": "bt_live_abcd1234",
    "estado": "activa",
    "activa": true,
    "fechaAlta": "2026-04-03 11:20:00",
    "fechaRevocacion": null,
    "ultimoUso": null,
    "rateLimitPerMinute": 180,
    "rateLimitPerHour": 3600,
    "rateLimitUnlimited": false,
    "maskedKey": "bt_live_abcd1234...e8d2"
  },
  "ApiKey": "bt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "Message": "Guarda esta API key ahora. Luego no podra volver a visualizarse."
}

Errores

400 El nombre de la API key es obligatorio.
403 La gestion de API keys requiere autenticacion de usuario.

400 El nombre de la API key es obligatorio.
403 La gestion de API keys requiere autenticacion de usuario.