مرجع API
حدود المعدل (Rate Limits)
تتضمن كل استجابة الترويسات التالية لمساعدتك في تتبع حدود المعدل واحترامها:
| الترويسة | الوصف |
|---|---|
x-rate-limit-limit | مدة نافذة حد المعدل الحالية (مثل 1m) |
x-rate-limit-remaining | الطلبات المتبقية في النافذة الحالية |
x-rate-limit-reset | طابع زمني بتنسيق ISO 8601 لإعادة ضبط النافذة الحالية |
الحدود
| نقطة النهاية | الحد |
|---|---|
/search | 7 طلبات كل 5 ثوانٍ |
/:category | 200 طلب في الدقيقة (لكل فئة) |
User-Agent
يجب أن تتضمن جميع الطلبات ترويسة User-Agent. يرجى استخدام التنسيق التالي: APP_NAME (CONTACT_INFO).
على سبيل المثال: NekoApp (https://example.com) أو NekoApp (dev@example.com)
إرشادات التسمية:
- كن محددًا: لا تستخدم أسماء عامة مثل "Discord Bot" أو "WhatsApp Bot" أو "Telegram Bot". يجب أن يكون لتطبيقك اسم فريد.
- تجنب العناصر الناقصة (Placeholders): لا تستخدم نصوصًا مثل
testأوbotأو قيمة المثال الموضحة أعلاه. - تجنب الافتراضيات للمكتبات: تجنب استخدام نصوص المكتبات الافتراضية مثل
python-requestsأوokhttpأوaxiosأوnodeأوGo-http-client.
خيارات معلومات الاتصال:
لا يلزم أن تكون معلومات الاتصال موقعًا إلكترونيًا تقليديًا. أي مما يلي يعد وسيلة مقبولة لتوفير الهوية:
- عنوان بريد إلكتروني للتواصل المباشر.
- موقع المشروع أو رابط مستودع عام (مثل GitHub، GitLab).
- رابط دعوة للبوت أو صفحة اكتشاف.
- رابط دليل (مثل top.gg أو أدلة مماثلة).
التزوير والانتحال:
- لا تقم بتزوير نصوص المتصفح. التنسيق
Mozilla/5.0 ...محجوز حصريًا لمتصفحات الويب الحقيقية والبوتات المعتمدة من Cloudflare. - لا تنتحل شخصية زواحف الشبكة المعروفة مثل
GooglebotأوBingbot.
سيؤدي عدم اتباع هذه الإرشادات واستخدام قيم عامة أو افتراضية أو مزيفة في الغالب إلى حظر طلباتك.
الفئات
تحدد الفئات نوع المحتوى المرجّع بواسطة API. ترتبط كل فئة بصيغة ملف ثابتة.
الصور
husbandokitsunenekowaifu
صور GIF
angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet
حقول الاستجابة
| النوع | الحقول |
|---|---|
| الصور | artist_name, artist_href, source_url |
| صور GIF | anime_name |
يتم تضمين url و dimensions في كليهما.