कोई परिणाम न देने वाला API और त्रुटि देने वाला API अलग-अलग प्रक्रियाओं की मांग करते हैं। सफल खोज में निर्दिष्ट क्षेत्र में कोई स्थान नहीं मिल सकता। नेटवर्क त्रुटि, सीमा पार होना या स्रोत अनुपलब्धता के कारण खोज से निष्कर्ष नहीं निकाला जा सकता।
ROOTE के लिए, HTTP उत्तर, व्यावसायिक स्थिति, अपेक्षित संग्रह और कवरेज की जांच करें। यह विधि यह रोकती है कि जब सेवाएं विफल हों या समय समाप्त हो जाए तो 'कोई शौचालय नहीं' या 'कोई रुकाव नहीं' जैसे संदेश न दिखाएं।
उत्तर के तीन स्तर पढ़ें
| स्तर | जांचें | संभव निष्कर्ष |
|---|---|---|
| ट्रांसपोर्ट | कनेक्शन, समय-सीमा और HTTP स्थिति | क्या अनुरोध सफल रहा? |
| संविदा | वैध JSON, संस्करण और अपेक्षित फ़ील्ड | क्या उत्तर उपयोगी है? |
| व्यावसायिक परिणाम | स्थिति, संग्रह, कवरेज, चेतावनियाँ और मेटा | निहित क्षेत्र में क्या ज्ञात है? |
केवल HTTP 200 कोड खोज को मान्य करने के लिए पर्याप्त नहीं है। उत्तर आंशिक निष्पादन या त्रुटि स्थिति दिखा सकता है। इसके विपरीत, किसी मार्ग पर 404 संग्रह के खाली होने का सामान्य तरीका नहीं है: URL और संविदा जांचें।
success, empty, partial और error को समझें
| स्थिति | अनुशंसित कार्रवाई |
|---|---|
| success | सत्यापन के बाद संस्थाओं को प्रदर्शित करें और सीमाएँ बनाए रखें |
| empty | यह सूचित करें कि इस खोज के लिए कोई परिणाम नहीं मिला |
| partial | उपयोग योग्य जानकारी के साथ उनके चेतावनी संदेश दिखाएं |
| error | खोज को अनुपलब्ध के रूप में प्रस्तुत करें; स्थानों की अनुपस्थिति पर निष्कर्ष न निकालें |
परिणाम का अभाव ज्ञात प्रश्न और स्रोतों पर आधारित है। यह भौतिक रूप से सेवा के अभाव का प्रमाण नहीं है। अधूरी कवरेज, प्रतिबंधित फ़िल्टर या लागू सीमाएँ परिणाम घटा सकती हैं।
आपके इंटरफ़ेस के लिए निर्णय वृक्ष
1. La requête a-t-elle abouti ?
Non → indisponibilité réseau ou délai dépassé.
2. Le statut HTTP est-il acceptable selon le contrat ?
Non → traiter le code et le message d'erreur.
3. Le JSON respecte-t-il le schéma attendu ?
Non → réponse inexploitable, jamais "aucun résultat".
4. Le statut métier est-il error ?
Oui → recherche indisponible.
5. Le statut est-il partial ou la couverture limitée ?
Oui → résultats utilisables + avertissement.
6. La collection attendue est-elle vide ?
Oui → aucun résultat retourné dans ce périmètre.
Non → afficher les résultats et leurs limites.सही क्रम में पैरामीटर जांचें
सबसे पहले अक्षांश और देशांतर, उनका क्रम और प्राप्त शहर जांचें। फिर त्रिज्या की इकाई और फ़िल्टर शब्दावली की जाँच करें। Services API में types=toilets होता है; नक्शे के URL में modes=toilets। ये विभिन्न संविदाओं के भाग हैं।
इसके बाद एक बार में केवल एक आयाम बढ़ाएँ: मार्ग की सीमाओं में त्रिज्या बढ़ाएँ या स्पष्ट परीक्षण के लिए एक फ़िल्टर हटाएँ। मूल अनुरोध का रिकॉर्ड रखें। यदि आप स्वतः विस्तार करते हैं, तो उपयोगकर्ता को नया क्षेत्र सूचित करें।
GPS निर्देशांकों के आसपास API खोज बनाना
एक स्रोत अनुपलब्ध होने पर अन्य को खोए बिना संभालना
आंशिक उत्तर में उन स्रोतों से स्थान हो सकते हैं जिन्होंने प्रतिक्रिया दी जबकि अन्य विफल हुए। इन परिणामों, उनके संदर्भों और संबंधित चेतावनी को बनाए रखें। सूची को पूर्ण न दिखाएँ और गायब क्षेत्रों को धोखा देने वाले डिफ़ॉल्ट मानों से न भरें।
कैश में रखी पुरानी जानकारी भी उपयोगी हो सकती है यदि आपकी नीति ऐसा विकल्प देती है। इसे पुराना बताते रहें। आपके अनुरोध का समय मूल अवलोकन को नया नहीं बनाता।
संदेश और प्रतिक्रियाएँ अनुकूलित करें
| स्थिति | आपके इंटरफ़ेस के लिए अनुकूलित संदेश | कर्म |
|---|---|---|
| empty | इस क्षेत्र में इन फ़िल्टरों के साथ कोई परिणाम नहीं मिला | क्षेत्र या फ़िल्टर बदलें |
| partial | कुछ परिणाम उपलब्ध हैं; खोज अधूरी है | परिणाम और चेतावनी दिखाएँ |
| सत्यापन त्रुटि | खोज में अमान्य पैरामीटर है | अनुरोध ठीक करें |
| प्रमाणीकरण या अधिकार | यह एक्सेस इस खोज की अनुमति नहीं देता | खाता या टोकन जांचें |
| सीमा या अनुपलब्धता | खोज अस्थायी रूप से अनुपलब्ध है | पुन: प्रयास निर्देशों का पालन करें |
429 पर सेवा के निर्देश और संभावित Retry-After देखें। 400 त्रुटि तर्क सुधारने की मांग करती है; एक ही अनुरोध दोहराने से समस्या नहीं हल होती। यदि उपयोगकर्ता ने टोकन दिया है तो 401 को स्वचालित गुमनाम कॉल में न बदलें।
प्रकाशित करने से पहले चार स्थितियां जांचें
पूर्ण, खाली, आंशिक और त्रुटिपूर्ण परीक्षण उत्तर, साथ ही अमान्य JSON और समय समाप्ति तैयार करें। दिखाए गए संदेश, संरक्षित परिणाम और पुनः प्रयासों की संख्या जांचें। मुख्य परीक्षण यह है कि विफलता कभी भी सेवा अनुपलब्धता की पुष्टि न करे।
एक AI सहायक पर इन नियमों को लागू करना
अक्सर पूछे जाने वाले प्रश्न
क्या खाली सूची शौचालयों की अनुपस्थिति साबित करती है?
नहीं। यह केवल बताती है कि इस खोज और पूछे गए स्रोतों के लिए कोई परिणाम नहीं मिला।
क्या आंशिक उत्तर दिखाया जा सकता है?
हाँ, यदि उपयोग की गई संस्थाएं मान्य हैं और आप आवश्यक चेतावनियाँ तथा सीमाएँ रखेंगे।
क्या हर त्रुटि पर पुनः प्रयास करना चाहिए?
नहीं। पैरामीटर या पहुंच त्रुटियों को सुधारें; अस्थायी घटनाओं के लिए पुनः प्रयास सीमित करें और सेवा निर्देशों का पालन करें।