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) |