Documentación·Auth & claves API
🔑

Auth & claves API

Tokens bearer, rotación de claves, lista blanca de IPs y errores que verás cuando la auth falla.

Tokens bearer

Cada petición a https://api.eveses.com lleva una clave API como token bearer:

Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

Las claves se crean en Account → API Keys. Trátalas como contraseñas — dan acceso completo al saldo, activaciones y alquileres.

Crear

Pulsa New key, asígnale una etiqueta (local-dev, ci, production-eu). El token se muestra una vez al crearlo — guárdalo de inmediato.

Rotar

Las claves no son editables. Para rotar: crea una nueva → cámbiala en tu despliegue → borra la antigua. El borrado es inmediato.

Lista blanca de IPs

Allowlist por clave: ata una clave a IPs / rangos CIDR específicos. Peticiones fuera de la lista obtienen 403. Configuración en la página de detalle de la clave.

Scopes

Todas las claves dan acceso total actualmente. Claves por scope (read-only, rentals-only) están en la roadmap.

Errores

HTTP Significado
401 Falta o está malformado el Authorization
403 Clave revocada, cuenta suspendida, o IP fuera de la allowlist
429 Rate limit por clave excedido (default 60 rpm)