À utiliser sur votre stream
Envoyez-nous le nom de votre catégorie Twitch et nous vous dirons si l'on peut mourir dans ce jeu. Votre bot peut utiliser la réponse pour activer ou désactiver un compteur de morts.
Les requêtes
Il y a deux adresses : l'une renvoie une phrase à publier dans le chat, l'autre la réponse seule. Chacune est une simple requête GET, avec le nom de la catégorie à la fin. Les deux reconnaissent les jeux de la même façon, et aucune clé ni inscription n'est nécessaire.
Pour le chat
GET https://can-i-die.in/api/chat/<nom de la catégorie>?lang=frUne phrase que votre bot peut publier telle quelle. En ce moment, elle dit :
- https://can-i-die.in/api/chat/Baldur's%20Gate%203?lang=fr
Vous pouvez mourir dans Baldur's Gate III.
- https://can-i-die.in/api/chat/Firewatch?lang=fr
Vous ne pouvez pas mourir dans Firewatch.
- https://can-i-die.in/api/chat/Just%20Chatting?lang=fr
Aucune mort dans Just Chatting. Le compteur de morts prend sa journée.
La phrase est en anglais, sauf si vous ajoutez ?lang= suivi de l'un de ces codes : en, fr, es, de, ja, ko, zh, it, pl, ru, ar. Les commandes de cette page demandent déjà la langue dans laquelle vous la lisez. La raison de la réponse est ajoutée quand nous l'avons rédigée dans cette langue.
Quand nous n'avons pas de réponse, la phrase le dit et demande de l'aide sur GitHub. Une catégorie qui n'est pas un jeu, comme Just Chatting, reçoit plutôt une blague, différente à chaque fois. Dans tous les cas, la réponse n'est jamais vide.
Pour l'automatisation
GET https://can-i-die.in/api/<nom de la catégorie>La réponse seule, pour un outil qui agit en fonction d'elle, comme Streamer.bot qui active ou désactive un compteur de morts.
La réponse est en texte brut, et prend l'une de ces trois formes :
- true
- On peut mourir dans ce jeu.
- false
- On ne peut pas mourir dans ce jeu.
- 404
- Une réponse vide. Aucun jeu ne porte ce nom, ou nous n'avons pas encore de réponse pour lui.
Le slug d'un jeu fonctionne à la place de son nom. Le slug est la dernière partie de l'adresse de la page du jeu sur ce site, par exemple baldurs-gate-iii.
Configurer votre bot
Chaque exemple ci-dessous lit votre catégorie actuelle et pose la question, de sorte que la réponse vous suit quand vous changez de jeu. Nightbot, StreamElements et Fossabot publient la phrase de l'adresse pour le chat. Streamer.bot reçoit la réponse seule, pour agir en fonction d'elle.
Streamer.bot
Ajoutez ces deux sous-actions à une action, dans cet ordre :
- Twitch › User › Get User Info for Target, avec User Login réglé sur
%broadcastUserName%. Votre catégorie se retrouve alors dans%game%. Si l'action n'est pas lancée par un déclencheur Twitch, placez Add Broadcaster Information avant. - Core › Network › Fetch URL, avec Variable Name réglé sur
canDieet cette adresse comme URL :https://can-i-die.in/api/%game%
%canDie% contient alors true, false, ou rien quand il n'y a pas de réponse. Testez-le avec une sous-action If/Else.
Nightbot
Envoyez ceci dans votre chat pour ajouter une commande !candie :
!commands add !candie $(urlfetch https://can-i-die.in/api/chat/$(querystring $(twitch $(channel) "{{game}}"))?lang=fr)StreamElements
Envoyez ceci dans votre chat :
!command add !candie $(customapi https://can-i-die.in/api/chat/$(pathescape $(game))?lang=fr)Fossabot
Créez une commande avec ceci comme réponse :
$(customapi https://can-i-die.in/api/chat/$(pathencode $(game))?lang=fr)Tout autre outil
Tout outil capable de charger une adresse web fonctionne. Les sources navigateur et les overlays peuvent aussi l'appeler, depuis n'importe quel site.
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"Comment les noms sont reconnus
Nos noms de jeux viennent d'IGDB, tout comme les catégories de Twitch, donc la plupart des noms correspondent tels quels. Les majuscules, les accents et la ponctuation sont ignorés, et le numéro d'une suite peut s'écrire des deux façons : « 3 » trouve « III », et « III » trouve « 3 ». Voici ce que renvoient quelques noms en ce moment :
| Nom envoyé | Réponse | Pourquoi |
|---|---|---|
| Firewatch | false | Un nom simple. Les majuscules ne comptent pas : « firewatch » et « FIREWATCH » fonctionnent aussi. |
| Pokémon Red Version | true | Les accents sont facultatifs. « Pokemon Red Version » trouve le même jeu. |
| Animal Crossing: New Horizons | false | La ponctuation est ignorée : les deux-points peuvent être omis. |
| Friday Night Funkin' | false | Les apostrophes sont facultatives. « Friday Night Funkin » fonctionne aussi. |
| Baldur's Gate 3 | true | Twitch nomme cette catégorie avec un 3, là où nos données ont III. Chiffres romains et chiffres ordinaires sont traités de la même façon, donc le nom Twitch trouve quand même le jeu. |
| Forza Horizon V | false | Pareil dans l'autre sens. Nos données ont ce jeu sous « Forza Horizon 5 ». |
| Fate/Grand Order | true | Une barre oblique dans le nom fonctionne, écrite telle quelle ou sous la forme %2F. |
| 100% Orange Juice | true | Un signe pour cent doit être envoyé sous la forme %25. Les bots le font pour vous quand vous utilisez leur variable d'encodage. |
| Until Dawn | false | Plusieurs jeux portent ce nom. Vous obtenez celui pour lequel nous avons une réponse, et le plus populaire d'entre eux. |
| Just Chatting | 404, vide | Ce n'est pas un jeu, donc il n'y a pas de réponse. |
| baldurs-gate-iii | true | Un slug, tiré de l'adresse de la page du jeu sur ce site. Il trouve toujours exactement ce jeu. |
Votre catégorie ne donne rien ? Cherchez le jeu dans la liste principale et utilisez plutôt le slug de sa page.