Skip to content

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écLeírás
x-rate-limit-limitAz aktuális rate limit ablak időtartama (pl. 1m)
x-rate-limit-remainingA jelenlegi ablakban még hátralévő kérések száma
x-rate-limit-resetISO 8601 időbélyeg arról, mikor áll vissza a jelenlegi időablak

Korlátok ​

VégpontKorlát
/search7 kérés / 5 másodperc
/:category200 kérés / perc (kategóriánként)
/:category/:filename.:format200 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, a bot, 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, node vagy Go-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 vagy Bingbot-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) ​

husbandokitsunenekowaifu

GIF-ek (59) ​

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Válaszmezők ​

TípusMezők
Képekartist_name, artist_href, source_url
GIF-ekanime_name

Az url és a dimensions mező mindkettőben szerepel.