API referencia
Rate limitek
Minden válasz tartalmazza az alábbi fejléceket, amelyek segítségével nyomon követheted és betarthatod a rate limiteket:
| Fejléc | Leírás |
|---|---|
x-rate-limit-limit | Az aktuális rate limit ablak időtartama (pl. 1m) |
x-rate-limit-remaining | A jelenlegi ablakban még hátralévő kérések száma |
x-rate-limit-reset | ISO 8601 időbélyeg arról, mikor áll vissza a jelenlegi időablak |
Korlátok
| Végpont | Korlát |
|---|---|
/search | 7 kérés / 5 másodperc |
/:category | 200 kérés / perc (kategóriánként) |
/:category/:filename.:format | 200 kérés / perc (megosztva a .png és .gif fájlok között) |
User-Agent
Bár az egyedi User-Agent fejléc megadása nem kötelező, javasoljuk, hogy állíts be egyet a kéréseidhez a következő formátumban: APP_NAME (CONTACT_INFO).
Például: NekoApp (https://example.com) vagy NekoApp (dev@example.com)
Ajánlott elnevezési irányelvek:
- Légy konkrét: Használd az alkalmazásod valódi nevét az olyan általános megnevezések helyett, mint a „Discord Bot”, „WhatsApp Bot” vagy „Telegram Bot”.
- Kerüld a helyőrzőket: Ne használj olyan helyőrző szövegeket, mint a
test, abot, vagy a fenti példaértékek. - Kerüld a könyvtárak alapértelmezett értékeit: Használj egyedi értéket az alapértelmezett könyvtár-azonosítók (például
python-requests,okhttp,axios,nodevagyGo-http-client) helyett.
Kapcsolattartási lehetőségek:
A kapcsolattartási adatnak nem kell hagyományos weboldalnak lennie. Az alábbiak bármelyike megfelelő:
- Közvetlen kapcsolattartási e-mail-cím.
- A projekt weboldala vagy egy nyilvános repository URL-je (pl. GitHub, GitLab).
- Bot meghívólink vagy bemutatóoldal.
- Katalógusoldal linkje (pl. top.gg vagy hasonló gyűjtőoldalak).
Hamisítás és megszemélyesítés:
- Ne hamisíts böngészőazonosítókat. A
Mozilla/5.0 ...formátum kizárólag valódi webböngészők és a Cloudflare által hitelesített botok számára van fenntartva. - Ne add ki magad ismert keresőrobotoknak, például
Googlebot-nak vagyBingbot-nak.
INFO
Ha nem adsz meg egyedi User-Agent fejlécet, nagyobb az esélye, hogy az automatikus visszaélés-észlelő rendszerünk megjelöl vagy kitilt (NB-BCFSD).
Kategóriák
A kategóriák határozzák meg az API által visszaadott tartalom típusát. Minden kategória egy fix fájlformátumhoz tartozik.
Képek (4)
GIF-ek (59)
Válaszmezők
| Típus | Mezők |
|---|---|
| Képek | artist_name, artist_href, source_url |
| GIF-ek | anime_name |
Az url és a dimensions mező mindkettőben szerepel.