Úsalo en tu directo
Envíanos el nombre de tu categoría de Twitch y te diremos si se puede morir en ese juego. Tu bot puede usar la respuesta para activar o desactivar un contador de muertes.
Las peticiones
Hay dos direcciones: una devuelve una frase para publicar en el chat y la otra, solo la respuesta. Cada una es una sola petición GET, con el nombre de la categoría al final. Las dos reconocen los juegos igual, y no hace falta clave ni registro.
Para el chat
GET https://can-i-die.in/api/chat/<nombre de la categoría>?lang=esUna frase que tu bot puede publicar tal cual. Ahora mismo dice:
- https://can-i-die.in/api/chat/Baldur's%20Gate%203?lang=es
Puedes morir en Baldur's Gate III.
- https://can-i-die.in/api/chat/Firewatch?lang=es
No puedes morir en Firewatch.
- https://can-i-die.in/api/chat/Just%20Chatting?lang=es
Nada muere en Just Chatting, salvo quizá la conversación.
La frase está en inglés, salvo que añadas ?lang= y uno de estos códigos: en, fr, es, de, ja, ko, zh, it, pl, ru, ar. Los comandos de esta página ya piden el idioma en el que la estás leyendo. El motivo de la respuesta se incluye cuando lo tenemos escrito en ese idioma.
Cuando no tenemos respuesta, la frase lo dice y pide ayuda en GitHub. Una categoría que no es un juego, como Just Chatting, recibe en su lugar un chiste, distinto cada vez. En cualquier caso, la respuesta nunca está vacía.
Para automatizar
GET https://can-i-die.in/api/<nombre de la categoría>Solo la respuesta, para una herramienta que actúe según ella, como Streamer.bot al activar o desactivar un contador de muertes.
La respuesta es texto sin formato, y es una de estas tres:
- true
- Se puede morir en este juego.
- false
- No se puede morir en este juego.
- 404
- Una respuesta vacía. Ningún juego tiene ese nombre, o todavía no tenemos respuesta para él.
El slug de un juego sirve en lugar de su nombre. El slug es la última parte de la dirección de la página del juego en este sitio, por ejemplo baldurs-gate-iii.
Configura tu bot
Cada ejemplo de abajo lee tu categoría actual y pregunta por ella, así que la respuesta te sigue cuando cambias de juego. Nightbot, StreamElements y Fossabot publican la frase de la dirección para el chat. Streamer.bot recibe solo la respuesta, para actuar según ella.
Streamer.bot
Añade estas dos subacciones a una acción, en este orden:
- Twitch › User › Get User Info for Target, con User Login puesto en
%broadcastUserName%. Esto deja tu categoría en%game%. Si la acción no la inicia un disparador de Twitch, pon Add Broadcaster Information antes. - Core › Network › Fetch URL, con Variable Name puesto en
canDiey esta dirección como URL:https://can-i-die.in/api/%game%
%canDie% contiene entonces true, false, o nada cuando no hay respuesta. Compruébalo con una subacción If/Else.
Nightbot
Envía esto en tu chat para añadir un comando !candie:
!commands add !candie $(urlfetch https://can-i-die.in/api/chat/$(querystring $(twitch $(channel) "{{game}}"))?lang=es)StreamElements
Envía esto en tu chat:
!command add !candie $(customapi https://can-i-die.in/api/chat/$(pathescape $(game))?lang=es)Fossabot
Crea un comando con esto como respuesta:
$(customapi https://can-i-die.in/api/chat/$(pathencode $(game))?lang=es)Cualquier otra herramienta
Sirve cualquier herramienta que pueda cargar una dirección web. Las fuentes de navegador y los overlays también pueden llamarla, desde cualquier sitio.
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"Cómo se reconocen los nombres
Nuestros nombres de juegos vienen de IGDB, de donde Twitch también saca sus categorías, así que la mayoría de los nombres coinciden tal cual. Se ignoran las mayúsculas, los acentos y la puntuación, y el número de una secuela puede escribirse de las dos formas: «3» encuentra «III», y «III» encuentra «3». Esto es lo que devuelven algunos nombres ahora mismo:
| Nombre enviado | Respuesta | Por qué |
|---|---|---|
| Firewatch | false | Un nombre sencillo. Las mayúsculas no importan: «firewatch» y «FIREWATCH» también funcionan. |
| Pokémon Red Version | true | Los acentos son opcionales. «Pokemon Red Version» encuentra el mismo juego. |
| Animal Crossing: New Horizons | false | La puntuación se ignora, así que los dos puntos pueden omitirse. |
| Friday Night Funkin' | false | Los apóstrofos son opcionales. «Friday Night Funkin» también funciona. |
| Baldur's Gate 3 | true | Twitch nombra esta categoría con un 3, donde nuestros datos tienen III. Los números romanos y los normales se tratan igual, así que el nombre de Twitch lo encuentra de todos modos. |
| Forza Horizon V | false | Lo mismo al revés. Nuestros datos tienen este juego como «Forza Horizon 5». |
| Fate/Grand Order | true | Una barra en el nombre funciona, escrita tal cual o como %2F. |
| 100% Orange Juice | true | Un signo de porcentaje debe enviarse como %25. Los bots lo hacen por ti cuando usas su variable de codificación. |
| Until Dawn | false | Varios juegos comparten este nombre. Recibes aquel para el que tenemos respuesta, y el más popular de ellos. |
| Just Chatting | 404, vacía | No es un juego, así que no hay respuesta. |
| baldurs-gate-iii | true | Un slug, tomado de la dirección de la página del juego en este sitio. Siempre encuentra exactamente ese juego. |
¿Tu categoría no encuentra nada? Busca el juego en la lista principal y usa el slug de su página.