Usalo sul tuo stream
Inviaci il nome della tua categoria Twitch e ti diremo se si può morire in quel gioco. Il tuo bot può usare la risposta per attivare o disattivare un contatore di morti.
La richiesta
È una sola richiesta GET, con il nome della categoria alla fine dell'indirizzo. Non serve né una chiave né un'iscrizione.
GET https://can-i-die.in/api/<nome della categoria>La risposta è testo semplice, e può essere una di tre cose:
- true
- In questo gioco si può morire.
- false
- In questo gioco non si può morire.
- 404
- Una risposta vuota. Nessun gioco ha quel nome, o non abbiamo ancora una risposta.
Al posto del nome funziona anche lo slug di un gioco. Lo slug è l'ultima parte dell'indirizzo della sua pagina qui, per esempio baldurs-gate-iii.
Configurare il bot
Ogni esempio qui sotto legge la tua categoria attuale e chiede di quella, così la risposta ti segue quando cambi gioco. I bot di chat scrivono la risposta come la parola “true” o “false”.
Streamer.bot
Aggiungi queste due sub-action a un'action, in questo ordine:
- Twitch › User › Get User Info for Target, con User Login impostato su
%broadcastUserName%. Questo mette la tua categoria in%game%. Se l'action non parte da un trigger Twitch, mettici davanti Add Broadcaster Information. - Core › Network › Fetch URL, con Variable Name impostato su
canDiee questo come URL:https://can-i-die.in/api/%game%
%canDie% conterrà poi true, false, o nulla quando non c'è risposta. Puoi verificarlo con una sub-action If/Else.
Nightbot
Invia questo in chat per aggiungere un comando !candie:
!commands add !candie Si può morire in $(twitch $(channel) "{{game}}")? $(urlfetch https://can-i-die.in/api/$(querystring $(twitch $(channel) "{{game}}")))Quando non c'è risposta, Nightbot scrive un proprio messaggio di errore al posto della risposta.
StreamElements
Invia questo in chat:
!command add !candie Si può morire in $(game)? $(customapi https://can-i-die.in/api/$(pathescape $(game)))Quando non c'è risposta, StreamElements scrive “The remote server returned status code 404”.
Fossabot
Crea un comando con questo come risposta:
Si può morire in $(game)? $(customapi https://can-i-die.in/api/$(pathencode $(game)))Quando non c'è risposta, Fossabot lascia la risposta vuota.
Qualsiasi altro strumento
Funziona qualsiasi strumento in grado di richiamare un indirizzo web. Possono farlo anche le browser source e le overlay, da qualsiasi sito.
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"Come vengono abbinati i nomi
I nostri nomi dei giochi vengono da IGDB, da cui Twitch prende anche le sue categorie, quindi la maggior parte dei nomi corrisponde già così. Maiuscole, accenti e punteggiatura vengono ignorati, e il numero di un sequel si può scrivere in entrambi i modi: “3” trova “III” e “III” trova “3”. Ecco cosa restituiscono alcuni nomi in questo momento:
| Nome inviato | Risposta | Perché |
|---|---|---|
| Firewatch | false | Un nome semplice. Le maiuscole non contano, quindi funzionano anche “firewatch” e “FIREWATCH”. |
| Pokémon Red Version | true | Gli accenti sono facoltativi. “Pokemon Red Version” trova lo stesso gioco. |
| Animal Crossing: New Horizons | false | La punteggiatura viene ignorata, quindi i due punti si possono omettere. |
| Friday Night Funkin' | false | Gli apostrofi sono facoltativi. Funziona anche “Friday Night Funkin”. |
| Baldur's Gate 3 | true | Twitch chiama questa categoria con un 3, mentre i nostri dati hanno III. I numeri romani e quelli normali sono trattati allo stesso modo, quindi il nome di Twitch lo trova comunque. |
| Forza Horizon V | false | Lo stesso al contrario. Nei nostri dati questo gioco è “Forza Horizon 5”. |
| Fate/Grand Order | true | Una barra nel nome funziona, scritta così com'è o come %2F. |
| 100% Orange Juice | true | Il segno di percentuale va inviato come %25. I bot lo fanno per te se usi la loro variabile di codifica. |
| Until Dawn | false | Diversi giochi hanno questo nome. Ottieni quello per cui abbiamo una risposta, e il più popolare tra quelli. |
| Just Chatting | 404, vuota | Non è un gioco, quindi non c'è risposta. |
| baldurs-gate-iii | true | Uno slug, preso dall'indirizzo della pagina del gioco qui. Trova sempre esattamente quel gioco. |
La categoria non trova nulla? Cerca il gioco nell'elenco principale e usa invece lo slug dalla sua pagina.