GET /stream

Status da live e dados do canal, lidos da Twitch na hora.

!titulo — o título de verdade, agora

É para isto que o modo texto existe. O ${title} do StreamElements vem do cache dele: depois que o !setduo carimba o título pela API, o cache continua mostrando o texto antigo — e parece um carimbo que não foi aplicado. Aqui o título é lido da Twitch na hora da chamada.

# StreamElements
$(customapi.https://www.asrus.app/api/v1/stream?format=text&key=SUA_CHAVE&r=titulo)

# Nightbot
!addcom !titulo $(urlfetch https://www.asrus.app/api/v1/stream?format=text&key=SUA_CHAVE&r=titulo)

A chave pode ser restrita ao grupo Leitura, que não muda nada em lugar nenhum. É a chave mais inofensiva que dá para colar num bot.

O que &r= aceita

r=resposta
titulo
ou title, nome
a | @coeiha @1vituvitu
categoria
ou jogo, game
Clair Obscur: Expedition 33
status
ou live
asrus12 está ao vivo há 2h13.
espectadores
ou viewers, publico
412 pessoas assistindo.
vazio ou desconhecido o resumo (abaixo)
# sem &r=, o resumo:
a | @coeiha @1vituvitu • Clair Obscur: Expedition 33 • há 2h13 • 412 pessoas

# offline, o resumo ainda diz o último título:
asrus12 não está ao vivo. Último título: a | @coeiha @1vituvitu

Em JSON

Sem ?format=text, a resposta é o objeto inteiro — é o que overlay e script consultam em loop.

curl -H "Authorization: Bearer $ASRUS_KEY" \
  https://www.asrus.app/api/v1/stream
{
  "canal": "asrus12",
  "stream": { "live": true, "startedAt": "...", "viewers": 412, "gameName": "...", "title": "..." },
  "info":   { "broadcasterId": "...", "login": "asrus12", "displayName": "...",
              "title": "a | @coeiha", "gameName": "...", "language": "pt", "tags": [] }
}

Canal offline simplesmente não aparece em /streams na Twitch, então stream.live vem false e o resto do objeto vem vazio — info continua preenchido.

Não exige escopo nenhum da Twitch: é leitura do que já é público no canal.