Skip to content

API रेफरेंस ​

रेट लिमिट ​

रेट लिमिट को ट्रैक करने और उसका पालन करने में आपकी मदद के लिए हर रिस्पॉन्स में निम्नलिखित हेडर्स शामिल होते हैं:

हेडरविवरण
x-rate-limit-limitवर्तमान रेट लिमिट विंडो की अवधि (उदाहरण के लिए 1m)
x-rate-limit-remainingवर्तमान विंडो में शेष रिक्वेस्ट की संख्या
x-rate-limit-resetवर्तमान विंडो रीसेट होने का ISO 8601 टाइमस्टैम्प

सीमाएं ​

एंडपॉइंटसीमा
/searchप्रति 5 सेकंड 7 रिक्वेस्ट
/:categoryप्रति मिनट 200 रिक्वेस्ट (प्रति कैटेगरी)
/:category/:filename.:formatप्रति मिनट 200 रिक्वेस्ट (.png और .gif एसेट्स के बीच साझा)

User-Agent ​

हालांकि कस्टम User-Agent हेडर अनिवार्य नहीं है, फिर भी हम सलाह देते हैं कि आप अपनी रिक्वेस्ट में इस फॉर्मेट का उपयोग करें: APP_NAME (CONTACT_INFO)।
उदाहरण के लिए: NekoApp (https://example.com) या NekoApp (dev@example.com)

नाम रखने के सुझाए गए दिशानिर्देश:

  • स्पष्ट नाम रखें: "Discord Bot", "WhatsApp Bot", या "Telegram Bot" जैसे सामान्य नामों के बजाय अपने एप्लिकेशन का वास्तविक नाम उपयोग करें।
  • प्लेसहोल्डर से बचें: test, bot, या ऊपर दिए गए उदाहरण जैसे प्लेसहोल्डर शब्दों का उपयोग न करें।
  • लाइब्रेरी डिफ़ॉल्ट से बचें: python-requests, okhttp, axios, node, या Go-http-client जैसी डिफ़ॉल्ट लाइब्रेरी स्ट्रिंग्स की जगह कस्टम वैल्यू का उपयोग करें।

संपर्क जानकारी (Contact Info) के विकल्प:
संपर्क जानकारी के लिए पारंपरिक वेबसाइट होना ज़रूरी नहीं है। इनमें से कोई भी विकल्प उपयुक्त है:

  • एक सीधा संपर्क ईमेल पता।
  • प्रोजेक्ट की वेबसाइट या पब्लिक रिपॉजिटरी का URL (जैसे GitHub, GitLab)।
  • बॉट इनवाइट लिंक या डिस्कवरी पेज।
  • कोई लिस्टिंग URL (जैसे top.gg या मिलती-जुलती डायरेक्टरी)।

स्पूफिंग और नकल (Impersonation):

  • ब्राउज़र स्ट्रिंग्स को स्पूफ न करें। Mozilla/5.0 ... फॉर्मेट केवल असली वेब ब्राउज़र और Cloudflare-सत्यापित बॉट्स के लिए आरक्षित है।
  • जाने-माने क्रॉलर्स की नकल न करें, जैसे Googlebot या Bingbot।

INFO

कस्टम User-Agent हेडर सेट न करने पर हमारे ऑटोमेटेड अब्यूज़ डिटेक्शन (NB-BCFSD) द्वारा फ्लैग या बैन किए जाने की संभावना बढ़ जाती है।

कैटेगरी ​

कैटेगरी यह तय करती हैं कि API किस प्रकार का कंटेंट लौटाएगा। हर कैटेगरी एक निश्चित फाइल फॉर्मेट से जुड़ी होती है।

इमेज (4) ​

husbandokitsunenekowaifu

GIF (59) ​

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

रिस्पॉन्स फ़ील्ड्स ​

प्रकारफ़ील्ड्स
इमेजartist_name, artist_href, source_url
GIFanime_name

url और dimensions दोनों में शामिल होते हैं।