Boykisser API

Boykisser API – darmowe, publiczne REST API służące do pobierania losowych obrazków z memem „Boykisser” — popularnej postaci z internetowej kultury furry. Autorem projektu jest Shieldziak.

Informacje ogólne

• Adres bazowy: https://boykisser.dsh.yt
• Dokumentacja (Swagger): https://boykisser.dsh.yt/docs
• Autoryzacja: nie wymagana — brak kluczy API ani rejestracji
• Limit żądań: 120 requestów na 60 sekund per adres IP

Opis

API umożliwia łatwe pobieranie losowych obrazków Boykissera bezpośrednio przez HTTP — bez logowania i bez konfiguracji. Idealne do botów Discord, projektów webowych czy memowych witryn.

Biblioteka zawiera 76 obrazków w czterech formatach: PNG, JPG, WebP i GIF, z obsługą konwersji formatu w locie (parametr ?format=webp).

Endpointy

Metoda	Endpoint	Opis
GET	/images	Zwraca liczbę obrazków i listę wszystkich nazw plików
GET	/random	Zwraca losowy obrazek (z pominięciem cache); obsługuje ?format=
GET	/random.png	Skrót do użycia bezpośrednio w <img src="...">
GET	/image/{name}	Zwraca konkretny obrazek po nazwie

Przykład użycia

HTML:

<img src="https://boykisser.dsh.yt/random.png" alt="Boykisser">

JS:

const res = await fetch("https://boykisser.dsh.yt/random?format=webp");
const blob = await res.blob();

Statystyki

• 76 obrazków w bibliotece
• 4 obsługiwane formaty
• 762 serwowanych obrazków (łącznie od uruchomienia)
• 0 wymaganych tokenów autoryzacyjnych

Ciekawostki:

• API zostało wykonane w Pythonie za pomocą biblioteki FastAPI
• API jest chronione oraz cachowane za pomocą Cloudflare
• API powstało aby dodać komendę /boykisser do bota discord HorniakOS