एक अनुरोध में संरचित वेब परिणाम

1. अपना पहला अनुरोध भेजें

q ही एकमात्र आवश्यक पैरामीटर है। पब्लिक टियर को Authorization हेडर नहीं चाहिए और यह मूल्यांकन व कम-मात्रा उपयोग के लिए उपयुक्त है।

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. स्रोत और कंटेंट सही ढंग से संभालें

source=local, TutuSoo इंडेक्स से आता है; source=brave लोकल कवरेज कम होने पर वेब फ़ॉलबैक है।

• नेविगेशन के लिए लौटाया गया url उपयोग करें; id से बाहरी पता कभी न निकालें।
• /api/v1/content/{id} केवल गैर-खाली id वाले लोकल परिणामों के लिए कॉल करें।
• 429, टाइमआउट, ऑफ़लाइन स्थिति और खाली परिणामों को बिना अनंत पुनः प्रयास के संभालें।

3. पेजिनेशन और संसाधन सीमाएं

वेब UI प्रति पेज 10 परिणाम दिखाता है और गहरे पेजिनेशन को सीमित करता है। API क्वेरी लंबाई, परिणाम संख्या और स्वीकृत गहराई सीमित करता है ताकि एक अनुरोध खोज संसाधनों पर एकाधिकार न करे।

• क्वेरी 512 वर्णों तक सीमित हैं।
• limit अधिकतम 100; 10–20 अनुशंसित।
• time_range, TutuSoo के crawl/index समय से फ़िल्टर करता है, न कि पेज प्रकाशन तिथि से।
• 429 या 503 प्रतिक्रियाओं के लिए सीमित एक्सपोनेंशियल बैकऑफ़ उपयोग करें ताकि retry storm न हो।