BonoVía
POST/v1/keysSin autenticación

Crear una API key

Alta self-service, sin autenticación previa — así es como consigues tu primera key.

Parámetros

NombreEnTipoRequeridoDescripción
emailbodystringopcionalOpcional — para poder contactarte si detectamos un problema con tu key.
expiresInDaysbody1 | 7 | 30 | 90 | nullopcionalCuándo expira la key. Omite el campo o pásalo como null para que no expire nunca (zona de peligro).

Ejemplo

Request
curl -X POST "https://api.bonovia.app/v1/keys" \
  -H "Content-Type: application/json" \
  -d '{"email": "tu@email.com", "expiresInDays": 30}'
Body
{
  "email": "tu@email.com",
  "expiresInDays": 30
}
Response
{
  "key": "bv_live_a1b2c3d4e5f6...",
  "prefix": "bv_live_a1b2c3d4",
  "created_at": "2026-09-24T12:00:00.000Z",
  "expires_at": "2026-10-24T12:00:00.000Z",
  "note": "Store this key now — it will not be shown again."
}