API Referansı
İstek Sınırlamaları (Rate Limits)
Her yanıt, istek sınırlarını takip etmenize ve bunlara uymanıza yardımcı olmak için aşağıdaki başlıkları içerir:
| Başlık | Açıklama |
|---|---|
x-rate-limit-limit | Mevcut istek sınırı penceresinin süresi (ör. 1m) |
x-rate-limit-remaining | Mevcut pencerede kalan istek sayısı |
x-rate-limit-reset | Mevcut pencerenin sıfırlanacağı ISO 8601 zaman damgası |
Sınırlar
| Uç Nokta | Sınır |
|---|---|
/search | 5 saniyede 7 istek |
/:category | Dakikada 200 istek (kategori başına) |
User-Agent
Tüm istekler bir User-Agent başlığı içermelidir. Lütfen şu formatı kullanın: UYGULAMA_ADI (İLETİŞİM_BİLGİSİ).
Örneğin: NekoApp (https://example.com) veya NekoApp (dev@example.com)
İsimlendirme Kuralları:
- Belirli olun: "Discord Bot", "WhatsApp Bot" veya "Telegram Bot" gibi genel isimler kullanmayın. Uygulamanızın kendine özgü bir adı olmalıdır.
- Yer tutuculardan kaçının:
test,botveya yukarıdaki örnek değerler gibi dizeleri kullanmayın. - Varsayılan kütüphane değerlerini kullanmayın:
python-requests,okhttp,axios,nodeveyaGo-http-clientgibi varsayılan kütüphane ifadelerini kullanmaktan kaçının.
İletişim Bilgisi Seçenekleri:
İletişim bilgisinin geleneksel bir web sitesi olması zorunlu değildir. Aşağıdakilerden herhangi biri geçerli kimlik sağlama yöntemleridir:
- Doğrudan bir iletişim e-posta adresi.
- Proje web sitesi veya herkese açık depo URL'si (ör. GitHub, GitLab).
- Bot davet bağlantısı veya tanıtım sayfası.
- Bir liste URL'si (ör. top.gg veya benzeri dizinler).
Taklit ve Kimliğe Bürünme:
- Tarayıcı dizelerini taklit etmeyin.
Mozilla/5.0 ...formatı yalnızca gerçek web tarayıcıları ve Cloudflare tarafından doğrulanmış botlar için ayrılmıştır. GooglebotveyaBingbotgibi bilinen arama motoru botlarının kimliğine bürünmeyin.
Bu kurallara uymamak ve genel, varsayılan veya taklit değerler kullanmak büyük olasılıkla isteklerinizin engellenmesiyle sonuçlanacaktır.
Kategoriler
Kategoriler, API tarafından döndürülen içerik türünü tanımlar. Her kategori sabit bir dosya formatıyla eşleşir.
Görseller
GIF'ler
Yanıt Alanları
| Tür | Alanlar |
|---|---|
| Görseller | artist_name, artist_href, source_url |
| GIF'ler | anime_name |
url ve dimensions alanları her iki türde de mevcuttur.