- API
- एंडपॉइंट्स
- /foods/search
Search foods by name
खाद्य-डायरी का उपयोग करने वाला व्यक्ति जिस तरह भोजन का नाम टाइप करता है, उसी तरह खाद्य पदार्थ खोजें। परिणाम दो कैटलॉग को मिलाते हैं: सामान्य खाद्य पदार्थ ("केला", "फुल क्रीम दूध"), जिनका संदर्भ आमतौर पर डायरी प्रविष्टि में होता है, और Tuduu मास्टर कैटलॉग के पैकेज किए गए उत्पाद। हर परिणाम में प्रति 100 ग्राम उसके मैक्रोन्यूट्रिएंट्स और उसकी मात्रा पहले से शामिल होती है, इसलिए खोज परिणाम दिखाने के लिए किसी अतिरिक्त कॉल की आवश्यकता नहीं होती। पेजों में 15 आइटम होते हैं और उनका आकार कॉन्फ़िगर नहीं किया जा सकता। जब क्वेरी किसी भी सामान्य खाद्य पदार्थ से मेल खाती है, तो अधिकतम 5 सामान्य खाद्य पदार्थ पहले पेज पर खुलते हैं; उस पेज पर उनके बाद और हर अगले पेज पर सभी परिणाम पैकेज किए गए कैटलॉग से आते हैं। स्क्रॉल करने के लिए प्राप्त 'meta.nextCursor' वापस भेजें; 'searchText' की आवश्यकता नहीं है: कर्सर में क्वेरी पहले से शामिल होती है और यदि आप दोनों भेजते हैं, तो कर्सर को प्राथमिकता मिलती है। null 'nextCursor' का अर्थ है कि आगे कुछ नहीं है। पहले 1000 पैकेज किए गए आइटमों के बाद स्क्रॉल रुक जाता है—उससे आगे पहुँचने के लिए क्वेरी को अधिक विशिष्ट बनाएं। मिलान में उच्चारण चिह्न, एकवचन/बहुवचन और अतिरिक्त संशोधक सहन किए जाते हैं: "caffè zuccherato" खाली सूची के बजाय कॉफी लौटाता है। केवल ज्ञात कैलोरी वाले खाद्य पदार्थ लौटाए जाते हैं; पैकेज किए गए परिणाम खाने योग्य श्रेणियों और ऐसे उत्पादों तक सीमित हैं जो किसी ब्रांड की घोषणा करते हैं, क्योंकि केवल नाम से वर्णित उत्पाद को उसके डुप्लिकेट से अलग नहीं किया जा सकता—ऐसे उत्पाद id के माध्यम से पता योग्य रहते हैं। जिन पैकेज किए गए परिणामों में मात्रा घोषित होती है, वे पहले आते हैं। केवल इतालवी: किसी अन्य Accept-Language के लिए यह endpoint 406 लौटाता है, क्योंकि सामान्य खाद्य नाम केवल इतालवी में मौजूद हैं।
अनुरोध
FoodSearchRequest
object
FoodSearchRequest
searchText?
खोजने के लिए मुक्त-पाठ खाद्य पदार्थ का नाम, जैसा डायरी उपयोगकर्ता टाइप करेगा। खोज शुरू करने के लिए आवश्यक; जब 'cursor' भी भेजा जाए तब अनदेखा किया जाता है
cursor?
पिछली कॉल द्वारा 'meta.nextCursor' के रूप में लौटाया गया अपारदर्शी टोकन, ताकि उसके बाद वाला पृष्ठ प्राप्त किया जा सके। इसमें क्वेरी पहले से शामिल होती है, इसलिए 'searchText' आवश्यक नहीं है और दोनों भेजे जाने पर अनदेखा किया जाता है। नई खोज शुरू करने के लिए कोई cursor न भेजें