Shoutout

Genera un mensaje de promoción con la categoría reciente y el enlace del canal objetivo. Consulta la API de Twitch en cada petición (sin caché KV como followage).

GEThttps://ttv.losperris.dev/api/shoutout

AutenticaciónTodos los endpoints requieren el parámetro apiKey en la query. Obtén la tuya desde el panel.›

Límites

Rate limit

Usa el límite general de tu rol (30–120 req/min). En respuestas exitosas, el CDN puede cachear el texto 10 segundos (Cache-Control: s-maxage=10).

Parámetros

Parámetro	Tipo	Requerido	Descripción
channel	String	Sí	Canal donde se ejecuta el comando.
touser	String	Sí	Streamer a promocionar.
apiKey	String	Sí	Clave de API de tu cuenta.
template	String	No	Plantilla con {user}, {game} y {url}.

Ejemplo de petición

cURLcURL -iURL

curl --request GET \
  --url 'https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY' \
  --header 'Accept: text/plain'

curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY' \
  --header 'Accept: text/plain'

https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY

Plantillas personalizadas

Añade template para controlar el mensaje. Placeholders: {user}, {game} y {url}.

cURLcURL -iURL

curl --request GET \
  --url 'https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY&template=Sigue+a+%7Buser%7D%2C+jugaba+%7Bgame%7D%3A+%7Burl%7D' \
  --header 'Accept: text/plain'

curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY&template=Sigue+a+%7Buser%7D%2C+jugaba+%7Bgame%7D%3A+%7Burl%7D' \
  --header 'Accept: text/plain'

https://ttv.losperris.dev/api/shoutout?channel=losperris&touser=ninja&apiKey=TU_API_KEY&template=Sigue+a+%7Buser%7D%2C+jugaba+%7Bgame%7D%3A+%7Burl%7D

Respuestas

200Canal no encontradoKey inválida (200)429

¡Vayan a seguir a ninja! Estaba jugando Fortnite

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

¡Vayan a seguir a ninja! Estaba jugando Fortnite

Canal no encontrado.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Canal no encontrado.

Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆

(sin contenido)

HTTP/1.1 429 Too Many Requests
Content-Type: text/plain; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Comportamiento en bots

Errores de API Key y de negocio devuelven **HTTP 200** con el mensaje en el cuerpo (así Nightbot y StreamElements lo muestran en el chat). El rate limit (**429**) devuelve **cuerpo vacío**.

Integración con bots

Restringe el comando a moderadores o al streamer en la configuración del bot.

Nightbot

!addcom !so $(urlfetch https://ttv.losperris.dev/api/shoutout?channel=$(channel)&touser=$(touser)&apiKey=TU_API_KEY)

StreamElements

!command add !so ${customapi.https://ttv.losperris.dev/api/shoutout?channel=${channel}&touser=${touser}&apiKey=TU_API_KEY}

Fossabot

!addcmd !so $(customapi https://ttv.losperris.dev/api/shoutout?channel=$(channel)&touser=$(touser)&apiKey=TU_API_KEY)

Wizebot

!command add !so $(urlfetch https://ttv.losperris.dev/api/shoutout?channel=$(channel)&touser=$(arg_touser)&apiKey=TU_API_KEY)

Streamlabs

{readapi.https://ttv.losperris.dev/api/shoutout?channel=TU_CANAL&touser={touser.name}&apiKey=TU_API_KEY}