VulCAT API cat

VulCAT to prosty serwis API udost臋pniaj膮cy zbi贸r zdj臋膰 kot贸w. Projekt zosta艂 stworzony, aby zapewni膰 zdj臋cia kotk贸w os贸b zwi膮zanych z Podziemiem Wulkanicznym w prostym do fetchowania formacie. Aktualnie jego g艂贸wne zastosowanie jest w Discordowym bocie Podziemnej Organizacji Wulkanicznej

Dost臋pne Endpointy

Lista wszystkich zdj臋膰

Pobierz list臋 wszystkich dost臋pnych zdj臋膰 kot贸w w formacie JSON.

GET https://vulcat.cvp.ovh/index.json

Zwraca obiekt JSON zawieraj膮cy tablic臋 images z pe艂nymi URLami do zdj臋膰 kot贸w.

Zdj臋cia w kategoriach

Pobierz list臋 zdj臋膰 podzielonych wed艂ug kategorii (kot贸w).

GET https://vulcat.cvp.ovh/separated.json

Zwraca obiekt JSON, gdzie kluczami s膮 nazwy kategorii (karmelek, bebe, jagoda, mrunia, inne), a warto艣ciami tablice z URLami do zdj臋膰 nale偶膮cych do danej kategorii.

Losowe zdj臋cie

Pobierz losowe zdj臋cie kota.

GET https://vulcat.cvp.ovh/random

Zwraca bezpo艣rednio obraz w formacie JPG/PNG.

WebUI

Przegl膮daj zdj臋cia kot贸w za pomoc膮 interfejsu webowego.

https://vulcat.cvp.ovh/web

Prosty interfejs wy艣wietlaj膮cy wszystkie zdj臋cia kot贸w w bazie.

Ciekawostki o kotach

Pobierz losow膮 ciekawostk臋 o kotach.

GET https://vulcat.cvp.ovh/catfacts.txt

Zbi贸r fakt贸w o kotach, kt贸ry mo偶esz wykorzysta膰 w swoich projektach.

Statystyki

Obecnie baza VulCAT zawiera prawie 400 zdj臋膰 kot贸w.

Jak u偶ywa膰

Przyk艂ad w JavaScript

// Pobieranie losowego zdj臋cia kota
const img = document.createElement('img');
img.src = 'https://vulcat.cvp.ovh/random';
document.body.appendChild(img);

// Pobieranie listy wszystkich zdj臋膰
fetch('https://vulcat.cvp.ovh/index.json')
  .then(response => response.json())
  .then(data => {
    console.log(`Liczba dost臋pnych zdj臋膰: ${data.images.length}`);
    // Zr贸b co艣 ze zdj臋ciami...
  });

// Pobieranie zdj臋膰 w kategoriach
fetch('https://vulcat.cvp.ovh/separated.json')
  .then(response => response.json())
  .then(data => {
    // Wy艣wietl zdj臋cia konkretnego kota
    const karmelekImages = data.karmelek;
    console.log(`Liczba zdj臋膰 Karmelka: ${karmelekImages.length}`);
  });

Projekt VulCAT

Projekt sk艂ada si臋 z kilku kluczowych element贸w:

Dla deweloper贸w

Projekt jest otwarty i mo偶na go rozszerzy膰. Je艣li chcesz doda膰 swoje zdj臋cia kot贸w lub ulepszy膰 API, zapraszamy do wsp贸艂pracy.

[email protected]