POST
/v1/keysSin autenticaciónCrear una API key
Alta self-service, sin autenticación previa — así es como consigues tu primera key.
Parámetros
| Nombre | En | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| body | string | opcional | Opcional — para poder contactarte si detectamos un problema con tu key. | |
| expiresInDays | body | 1 | 7 | 30 | 90 | null | opcional | Cuá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."
}El valor de key sólo se muestra una vez — guárdalo, no hay forma de recuperarlo después.
Límite: 5 keys nuevas por hora por dirección IP.
Sin expiresInDays, la key no expira nunca. Puedes revocarla tú mismo cuando quieras.
Errores posibles de este endpoint
400
expiresInDays no es 1, 7, 30 ni 90 (y tampoco null/omitido).
{ "error": "expiresInDays must be one of 1, 7, 30, 90, or omitted/null for never" }400
El email no tiene un formato válido.
{ "error": "Invalid email" }429
Más de 5 keys creadas desde tu IP en la última hora.
{ "error": "Too many requests" }