Referensi API

Batasan Laju (Rate Limits)

Setiap respons menyertakan header berikut untuk membantu Anda memantau dan mematuhi batasan laju:

Header	Deskripsi
x-rate-limit-limit	Durasi jendela batas laju saat ini (mis. 1m)
x-rate-limit-remaining	Sisa permintaan dalam jendela saat ini
x-rate-limit-reset	Stempel waktu ISO 8601 saat jendela saat ini diatur ulang

Batasan

Endpoint	Batas
/search	7 permintaan per 5 detik
/:category	200 permintaan per menit (per kategori)

User-Agent

Semua permintaan harus menyertakan header User-Agent. Silakan gunakan format berikut: NAMA_APLIKASI (INFO_KONTAK).
Contoh: NekoApp (https://example.com) atau NekoApp (dev@example.com)

Panduan Penamaan:

• Spesifik: Jangan gunakan nama umum seperti "Discord Bot", "WhatsApp Bot", atau "Telegram Bot". Aplikasi Anda harus memiliki nama yang unik.
• Hindari tempat penampung (placeholders): Jangan gunakan string seperti test, bot, atau nilai contoh di atas.
• Bukan default pustaka: Hindari menggunakan string default pustaka seperti python-requests, okhttp, axios, node, atau Go-http-client.

Pilihan Informasi Kontak:
Informasi kontak tidak harus berupa situs web tradisional. Salah satu dari cara berikut dapat diterima sebagai identifikasi:

• Alamat email kontak langsung.
• Situs web proyek atau URL repositori publik (misalnya GitHub, GitLab).
• Tautan undangan bot atau halaman penemuan (discovery page).
• URL pendaftaran (misalnya top.gg atau direktori serupa).

Spoofing dan Penyamaran:

• Jangan memalsukan string peramban. Format Mozilla/5.0 ... khusus diperuntukkan bagi peramban web asli dan bot yang diverifikasi Cloudflare.
• Jangan menyamar sebagai crawler terkenal seperti Googlebot atau Bingbot.

Kegagalan mengikuti panduan ini dan penggunaan nilai umum, default, atau palsu kemungkinan besar akan mengakibatkan permintaan Anda diblokir.

Kategori

Kategori menentukan jenis konten yang dikembalikan oleh API. Setiap kategori dipetakan ke format berkas tetap.

Gambar

husbandokitsunenekowaifu

GIF

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Bidang Respons (Response Fields)

Tipe	Bidang
Gambar	artist_name, artist_href, source_url
GIF	anime_name

url dan dimensions disertakan dalam keduanya.