Tu API Key

La API Key identifica tu cuenta en peticiones de bot. Es un UUID generado en tu primer login con Twitch y visible en Configuración → Seguridad (/dashboard/settings/seguridad).

---

Obtener tu clave

1. Inicia sesión con Twitch en ttv.losperris.dev.
2. Abre el menú de tu cuenta (arriba a la derecha) → Configuración → pestaña Seguridad.
3. En la pestaña Seguridad, revela la clave (se oculta sola tras 30 s), cópiala o usa Regenerar si crees que se filtró.

Si regeneras la clave

La clave anterior deja de funcionar al instante. Actualiza todas las URLs en Nightbot, StreamElements, Fossabot y Wizebot.

---

Cómo enviar la clave (bots)

Parámetro	Tipo	Requerido	Descripción
apiKey	String	Sí	UUID de tu cuenta. Query param en la mayoría de ejemplos de esta documentación.

Alternativa por cabecera (útil en scripts):

X-Api-Key: TU_API_KEY

Ejemplo de URL

https://ttv.losperris.dev/api/followage?channel=TU_CANAL&user=VIEWER&apiKey=TU_API_KEY

Seguridad

No publiques tu API Key en repositorios, vídeos ni capturas. Cualquiera con la clave consume tu cuota de rate limit.

---

Panel vs bots

Contexto	Autenticación	Límite típico
Bots de chat (/followage, /magic8, …)	apiKey o X-Api-Key	30–120 req/min según rol
Panel (/api/dashboard/*)	Cookie de sesión HttpOnly (lp_sess)	500 req/min
Overlays OBS	Token de solo lectura (overlayToken)	Lectura del estado publicado

Sesión del panel

El dashboard autentica con una cookie HttpOnly (lp_sess) tras el login con Twitch. Los bots solo necesitan la API Key en la URL o cabecera; no hace falta OAuth en Nightbot ni similares.

---

Permisos de Twitch al conectar

Al vincular tu cuenta solo pedimos scopes necesarios para leer información pública y ejecutar lo que configuras (clips, chat, moderación básica, etc.):

• user:read:email, moderator:read:followers, clips:edit
• moderator:read:chatters, user:write:chat, chat:read, chat:edit
• moderator:manage:banned_users, channel:read:vips, channel:read:subscriptions

No solicitamos contraseña ni Stream Key.

---

Validar sesión (panel)

El frontend llama a GET /api/system/validate al cargar (con cookie lp_sess). Respuesta exitosa (resumen):

	{"valid": true,"tokenExpiresAt": "…","user": {"id": "…","login": "tu_canal","display_name": "Tu Canal","profile_image_url": "…","timezone": "Europe/Madrid"}}

La API Key no viaja en validate: se revela solo desde Configuración → Seguridad cuando la necesitas para bots.

Los tokens de overlay devuelven 403 en validate — son de solo lectura y no representan sesión de panel.

---

Enlaces

Perfil y seguridadRegenerar clave, exportar datos y eliminar cuenta.

Límites de usoCuota por rol, panel y endpoints pesados.

Inicio rápidoTu primer comando en el chat.