Użyj tego na swoim streamie
Wyślij nam nazwę swojej kategorii na Twitchu, a powiemy ci, czy w tej grze można zginąć. Twój bot może użyć odpowiedzi, by włączyć lub wyłączyć licznik śmierci.
Zapytania
Są dwa adresy: jeden zwraca zdanie do wysłania na czacie, a drugi samą odpowiedź. Każdy to jedno zapytanie GET z nazwą kategorii na końcu. Oba rozpoznają gry tak samo i nie potrzebujesz klucza ani rejestracji.
Na czat
GET https://can-i-die.in/api/chat/<nazwa kategorii>?lang=plZdanie, które bot może wysłać bez zmian. W tej chwili brzmi tak:
- https://can-i-die.in/api/chat/Baldur's%20Gate%203?lang=pl
Możesz zginąć w Baldur's Gate III.
- https://can-i-die.in/api/chat/Firewatch?lang=pl
Nie możesz zginąć w Firewatch.
- https://can-i-die.in/api/chat/Just%20Chatting?lang=pl
W Just Chatting nic nie ginie, może poza rozmową.
Zdanie jest po angielsku, chyba że dodasz ?lang= i jeden z tych kodów: en, fr, es, de, ja, ko, zh, it, pl, ru, ar. Polecenia na tej stronie już proszą o język, w którym ją czytasz. Powód odpowiedzi jest dołączany, gdy mamy go napisanego w tym języku.
Gdy nie znamy odpowiedzi, zdanie to mówi i prosi o pomoc na GitHubie. Kategoria, która nie jest grą, jak Just Chatting, dostaje zamiast tego żart, za każdym razem inny. Tak czy inaczej odpowiedź nigdy nie jest pusta.
Do automatyzacji
GET https://can-i-die.in/api/<nazwa kategorii>Sama odpowiedź, dla narzędzia, które na jej podstawie działa, na przykład Streamer.bota, który włącza lub wyłącza licznik śmierci.
Odpowiedź to zwykły tekst i jedna z trzech rzeczy:
- true
- W tej grze można zginąć.
- false
- W tej grze nie można zginąć.
- 404
- Pusta odpowiedź. Żadna gra nie ma tej nazwy albo nie mamy jeszcze dla niej odpowiedzi.
Zamiast nazwy gry działa też jej slug. Slug to ostatnia część adresu strony gry na tej witrynie, na przykład baldurs-gate-iii.
Konfiguracja bota
Każdy przykład poniżej odczytuje twoją aktualną kategorię i o nią pyta, więc odpowiedź zmienia się razem z grą. Nightbot, StreamElements i Fossabot wysyłają zdanie z adresu na czat. Streamer.bot dostaje samą odpowiedź, by na jej podstawie działać.
Streamer.bot
Dodaj do akcji te dwie podakcje, w tej kolejności:
- Twitch › User › Get User Info for Target, z User Login ustawionym na
%broadcastUserName%. Dzięki temu twoja kategoria trafi do%game%. Jeśli akcji nie uruchamia wyzwalacz z Twitcha, dodaj przed nią Add Broadcaster Information. - Core › Network › Fetch URL, z Variable Name ustawionym na
canDiei tym adresem jako URL:https://can-i-die.in/api/%game%
%canDie% zawiera wtedy true, false albo nic, gdy nie ma odpowiedzi. Sprawdź to podakcją If/Else.
Nightbot
Wyślij to na czacie, by dodać polecenie !candie:
!commands add !candie $(urlfetch https://can-i-die.in/api/chat/$(querystring $(twitch $(channel) "{{game}}"))?lang=pl)StreamElements
Wyślij to na czacie:
!command add !candie $(customapi https://can-i-die.in/api/chat/$(pathescape $(game))?lang=pl)Fossabot
Utwórz polecenie z tym jako odpowiedzią:
$(customapi https://can-i-die.in/api/chat/$(pathencode $(game))?lang=pl)Wszystko inne
Zadziała każde narzędzie, które potrafi pobrać adres internetowy. Źródła przeglądarki i nakładki też mogą go wywołać, z dowolnej strony.
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"Jak dopasowujemy nazwy
Nasze nazwy gier pochodzą z IGDB, skąd Twitch też bierze swoje kategorie, więc większość nazw pasuje bez zmian. Wielkość liter, znaki diakrytyczne i interpunkcja są pomijane, a numer kontynuacji można zapisać na dwa sposoby: „3” znajduje „III”, a „III” znajduje „3”. Oto co niektóre nazwy zwracają w tej chwili:
| Wysłana nazwa | Odpowiedź | Dlaczego |
|---|---|---|
| Firewatch | false | Zwykła nazwa. Wielkość liter nie ma znaczenia, więc „firewatch” i „FIREWATCH” też działają. |
| Pokémon Red Version | true | Znaki diakrytyczne są opcjonalne. „Pokemon Red Version” znajduje tę samą grę. |
| Animal Crossing: New Horizons | false | Interpunkcja jest pomijana, więc dwukropek można pominąć. |
| Friday Night Funkin' | false | Apostrofy są opcjonalne. „Friday Night Funkin” też działa. |
| Baldur's Gate 3 | true | Twitch nazywa tę kategorię z cyfrą 3, a w naszych danych jest III. Cyfry rzymskie i zwykłe traktujemy tak samo, więc nazwa z Twitcha i tak ją znajduje. |
| Forza Horizon V | false | To samo w drugą stronę. W naszych danych ta gra to „Forza Horizon 5”. |
| Fate/Grand Order | true | Ukośnik w nazwie działa, zapisany wprost lub jako %2F. |
| 100% Orange Juice | true | Znak procentu trzeba wysłać jako %25. Boty robią to za ciebie, gdy używasz ich zmiennej kodującej. |
| Until Dawn | false | Kilka gier ma tę nazwę. Dostajesz tę, dla której mamy odpowiedź, i najpopularniejszą z nich. |
| Just Chatting | 404, pusto | To nie gra, więc nie ma odpowiedzi. |
| baldurs-gate-iii | true | Slug wzięty z adresu strony gry na tej witrynie. Zawsze znajduje dokładnie tę grę. |
Kategoria nic nie znajduje? Wyszukaj grę na głównej liście i użyj sluga z jej strony.