Status da live e dados do canal, lidos da Twitch na hora.
É 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.
&r= aceita| r= | resposta |
|---|---|
tituloou title, nome |
a | @coeiha @1vituvitu |
categoriaou jogo, game |
Clair Obscur: Expedition 33 |
statusou live |
asrus12 está ao vivo há 2h13. |
espectadoresou 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
/channels, não de /streams.
Offline o /streams da Twitch não devolve nada, e é justamente offline que
alguém quer conferir o título que ficou. Por isso &r=titulo responde
com o canal no ar ou não.&r= que não existe cai no resumo, não em erro: no chat, o
silêncio custa menos que uma mensagem de erro por causa de um nome errado.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.