Ir al contenido
LosPerris API

Inicio rápido

Sigue estos pasos para tener tu primer comando en el chat. La API vive en https://ttv.losperris.dev/api (mismo dominio que el panel).

  1. Entra en ttv.losperris.dev y pulsa Iniciar sesión con Twitch.
  2. Lee y acepta el aviso de privacidad; se abrirá el OAuth de Twitch.
  3. Tras el login llegarás al dashboard. Abre el menú de tu cuenta (arriba a la derecha) → Configuración → Seguridad y copia tu API Key (UUID).
  4. En la barra lateral del panel, abre Followage (u otro comando) — por ejemplo documentación de Followage.
  5. En el generador de comandos, elige tu bot (Nightbot, StreamElements, Fossabot o Wizebot), copia la línea ya con tu API Key y pégala en el panel del bot.
  6. Opcional: usa Probar API en el panel para ver la respuesta antes de publicar.
  7. Prueba en tu chat: !followage @viewer

URL base de la API

Sección titulada «URL base de la API»

Todos los ejemplos de esta documentación usan:

https://ttv.losperris.dev/api/<endpoint>?apiKey=TU_API_KEY&...

También puedes enviar la clave en la cabecera X-Api-Key en lugar del query param.

Compatibilidad legacy: funciona el prefijo /twitch/ (ej. https://ttv.losperris.dev/twitch/followage?...) para bots antiguos.

Dos formas de autenticarte

Sección titulada «Dos formas de autenticarte»
Uso Método Dónde
Bots de chat apiKey en la URL o X-Api-Key Nightbot, StreamElements, scripts
Panel web Cookie de sesión HttpOnly (lp_sess) Dashboard, overlays, analytics

Los bots no necesitan iniciar sesión en el panel: solo la API Key. El panel usa OAuth además de la clave para rutas /api/dashboard/*.

Siguiente paso

Sección titulada «Siguiente paso»
Tu API KeyFormato UUID, cabeceras, regenerar clave y permisos OAuth.
Panel de controlPestañas del dashboard, realtime y acceso a Configuración.
Límites de usoRate limits por rol, panel (500/min) y endpoints pesados.
FollowageTu primer endpoint: parámetros, plantillas y respuestas.