A rota do duo por HTTP: métodos, campos, a gramática dos apelidos e as regras do carimbo.
!duo funcionando no chat? Os comandos prontos estão
em !duo e !setduo. Esta página é a referência da rota.GET /api/v1/duo → quem é o duo
GET /api/v1/duo?set=fulano → define
GET /api/v1/duo?clear=1 → limpa
POST /api/v1/duo {"login":"..."} → define
DELETE /api/v1/duo → limpa
curl -H "Authorization: Bearer $ASRUS_KEY" https://www.asrus.app/api/v1/duo
curl -X POST -H "Authorization: Bearer $ASRUS_KEY" \
-H "Content-Type: application/json" \
-d '{"login":"Speed (justwspeed), fulano"}' \
https://www.asrus.app/api/v1/duo
Com ?format=text a resposta vira uma linha limpa em vez de JSON — é o que
o bot repete no chat. Vale também para os erros.
O mesmo texto vale no ?set= e no login do POST. Uma pessoa é
um login da Twitch, opcionalmente precedido de um apelido com o login
entre parênteses.
| texto | vira |
|---|---|
fulano | uma pessoa, login fulano |
fulano ciclano | duas — sem parênteses, o espaço já separa |
fulano, ciclano | duas |
Speed (justwspeed) | uma, apelido Speed |
Zé da Silva (zedasilva) | uma — com parênteses, o apelido pode ter espaço |
Speed (justwspeed) fulano | duas — depois do ) já começa outra |
fulano, Maria (maria2) | duas |
fulano Maria (maria2) | uma, apelido fulano Maria |
A regra, em uma frase: uma pessoa termina no ) quando abre
parênteses antes de qualquer vírgula; senão, termina no primeiro espaço ou vírgula.
É daí que vem a última linha da tabela, e é por isso que a vírgula existe.
@ na frente do login é aceito e ignorado.?channel= escolhe. Sem ele, é o canal da própria chave —
então um comando instalado no chat de outra pessoa, sem esse campo, grava o duo e carimba
o título do dono da chave, e responde como se tivesse funcionado.
GET /api/v1/duo?key=SUA_CHAVE&channel=bnvlr&set=sasuke (justwspeed)
channel:manage:broadcast e te adicionado na lista de usuários permitidos
dela. Faltando um dos dois, a resposta diz o que falta.channel quer dizer outra coisa — o canal a
clipar, que não exige autorização. Aqui é "qual canal operar".No título vai sempre | @login, mesmo quando existe apelido: ali o nome
serve para achar a pessoa na Twitch, e @Speed não acha ninguém.
@. Um subtítulo com barra —
"Live de hoje | Valorant ranqueada" — fica intacto. (Até a versão anterior
não ficava: qualquer palavra depois da barra casava como carimbo e sumia no primeiro
!setduo.)cortouOTitulo: true quando isso acontece.channel:manage:broadcast — é o escopo que
deixa mexer no título.É feio, e é proposital. Nightbot e StreamElements só sabem fazer GET
num comando customizado — sem cabeçalho, sem corpo, sem escolher método. Ou a API fala
essa língua, ou !setduo não existe.
A trava que compensa isso está na autenticação: chave vinda da URL precisa ser restrita, então a chave colada no bot só mexe no duo.