GET /duo

A rota do duo por HTTP: métodos, campos, a gramática dos apelidos e as regras do carimbo.

Só quer o !duo funcionando no chat? Os comandos prontos estão em !duo e !setduo. Esta página é a referência da rota.

Métodos

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.

A gramática do campo

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.

textovira
fulanouma pessoa, login fulano
fulano ciclanoduas — sem parênteses, o espaço já separa
fulano, ciclanoduas
Speed (justwspeed)uma, apelido Speed
Zé da Silva (zedasilva)uma — com parênteses, o apelido pode ter espaço
Speed (justwspeed) fulanoduas — 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.

Qual canal a chamada opera

?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)

O carimbo no título

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.

Por que um GET muda estado

É 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.