Docs / Consola

Consola de Webability

Administra tus llaves API, productos, métricas, logs, alertas y facturación desde un solo panel.

Introducción

La consola es el centro de control para operar tus servicios: crea y rota API keys, define límites, revisa consumo y latencias, consulta logs, configura webhooks/alertas y administra tu plan.

Desde la consola puedes

• Crear / revocar API keys
• Ver consumo por producto
• Consultar logs por request
• Configurar alertas y webhooks

Buenas prácticas

• 1 key por entorno (dev/stg/prod)
• Rotación periódica
• Límites por producto
• Alertas por picos de error

Acceso y cuentas

Inicia sesión con tu cuenta. Si perteneces a una organización, podrás alternar entre proyectos o equipos. Recomendamos habilitar MFA/2FA cuando esté disponible.

URLs

Consola: https://www.webability.info/consola
Registro: /registro

API Keys

Recomendación: 1 key por entorno

Las API keys autentican tus requests. Puedes crear, limitar, rotar y revocar keys desde la consola. Manténlas fuera del frontend y no las publiques en repositorios.

Crear key

• Nombre (ej. prod)
• Permisos por producto
• Orígenes permitidos (opcional)
• Límites (opcional)

Rotación

• Genera una nueva key
• Actualiza tu app/infra
• Revoca la anterior
• Verifica logs y métricas

Uso en requests

curl -H "Authorization: Bearer WA_API_KEY" "https://api.webability.info/resize?url=...&w=800&format=webp"

Productos

Activa o desactiva productos por proyecto y define límites de consumo por módulo (imágenes, mailing, video, etc.).

Imágenes

Resize / WebP / AVIF · Caché · Dominios permitidos

Mailing

Listas · Campañas · Métricas · Webhooks

Video

Jobs · Perfiles · HLS · CDN

Consola

Métricas, logs, alertas y administración

Métricas

Visualiza consumo por producto y API key: requests, bytes, latencias (p50/p95), error rate y caché hit ratio.

Métrica	Qué indica
requests	Volumen total por periodo.
p95 latency	Tiempo de respuesta en el 95% de requests.
error rate	% de errores (4xx/5xx).
cache hit	% de respuestas servidas desde caché.

Logs

Consulta requests recientes: endpoint, parámetros, status code, latencia, IP, cache status y errores. Útil para debugging y auditoría.

Ejemplo de registro

{
  "ts": "2026-01-07T22:31:10-06:00",
  "product": "images",
  "endpoint": "/resize",
  "status": 200,
  "latency_ms": 74,
  "cache": "HIT",
  "key": "prod",
  "ip": "x.x.x.x"
}

Alertas

Configura alertas por picos de error, aumento de latencia o consumo fuera de lo esperado. Puedes recibir notificaciones por email o webhook.

Ejemplos

• Error rate > 2% durante 5 min
• p95 latency > 300ms durante 10 min
• 80% del plan consumido

Canales

• Email
• Webhook
• (Opcional) Slack / Teams

Facturación

Administra plan, pagos, facturas y consumo por periodo. Configura datos fiscales y descarga comprobantes (según disponibilidad y país).

Incluye

• Cambio de plan
• Métodos de pago
• Historial de facturas
• Alertas de consumo

Roles y permisos

Para equipos, asigna roles por proyecto (admin, developer, billing, viewer). Limita accesos por módulo.

Rol	Permisos típicos
Admin	Todo: keys, productos, usuarios, facturación.
Developer	Keys, métricas, logs, configuración técnica.
Billing	Facturas, plan, pagos.
Viewer	Solo lectura: métricas y estado.

Seguridad

• Protege tus API keys (no exponer en frontend).
• Limita orígenes/domínios permitidos cuando aplique.
• Revisa logs ante actividad sospechosa.
• Habilita MFA/2FA para cuentas de consola (si aplica).

FAQ

¿Dónde encuentro mi API key?

Consola → API Keys → Crear o copiar la key existente.

¿Puedo limitar por dominio o IP?

Sí, cuando el plan lo permite, desde la configuración de la key.

¿Cómo veo errores de mis requests?

Consola → Logs → filtra por producto, endpoint o status code.