ফলাফলহীন API এবং ত্রুটিপূর্ণ API-এর জন্য আলাদা প্রক্রিয়া প্রয়োজন। সফল অনুসন্ধান ক্ষেত্রের মধ্যে কোনও স্থান ফেরত না দিতে পারে। নেটওয়ার্ক ত্রুটি, সীমা ছাড়িয়ে যাওয়া বা উৎস অনুপলব্ধ হলে অনুসন্ধান থেকে সরাসরি সিদ্ধান্ত নেওয়া যায় না।
ROOTE-এর ক্ষেত্রে প্রথমে HTTP প্রতিক্রিয়া এবং পরে ব্যবসায়িক স্থিতি, প্রত্যাশিত কালেকশন এবং কাভারেজ যাচাই করুন। এই পদ্ধতি ব্যর্থ সেবাসমূহের জন্য 'কোন টয়লেট নেই' বা সময়সীমা অতিবাহিত হওয়ার পর 'কোন স্টপ নেই' দেখানো এড়ায়।
একটি প্রতিক্রিয়ার তিনটি স্তর পড়ুন
| স্তর | যা যাচাই করবেন | সম্ভাব্য সিদ্ধান্ত |
|---|---|---|
| পরিবহন | সংযোগ, সময়সীমা ও HTTP স্থিতি | অনুরোধ কি সফল হয়েছিল? |
| চুক্তি | বৈধ JSON, সংস্করণ এবং প্রত্যাশিত ক্ষেত্র | প্রতিক্রিয়া ব্যবহারযোগ্য কি? |
| ব্যবসায়িক ফলাফল | status, collections, coverage, warnings এবং meta | অনুরোধকৃত ক্ষেত্রের মধ্যে কি জানা যায়? |
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 এবং সময়সীমা-অতিক্রমণসহ পরীক্ষা উত্তর প্রস্তুত করুন। প্রদর্শিত বার্তা, রাখা ফলাফল ও পুনরুদ্ধারের সংখ্যাও যাচাই করুন। মূল পরীক্ষা: ত্রুটি কখনো পরিষেবার অনুপস্থিতি দাবী না করে।
একটি এআই সহকারীকে এই নিয়ম প্রয়োগ করুন
সাধারণ প্রশ্ন
একটি খালি তালিকা কি টয়লেটের অনুপস্থিতি প্রমাণ করে?
না। এটি শুধু দেখায় যে এই অনুসন্ধান ও উৎস থেকে কোনো ফলাফল পাওয়া যায়নি।
আংশিক প্রতিক্রিয়া দেখানো যায়?
হ্যাঁ, যদি ব্যবহারযোগ্য সত্তা বৈধ হয় এবং প্রয়োজনীয় সতর্কতা ও সীমাবদ্ধতা রাখা হয়।
প্রতিটি ত্রুটি পুনরায় চেষ্টা করা জরুরি?
না। প্যারামিটার বা প্রবেশাধিকার ত্রুটি সংশোধন করুন; অস্থায়ী সমস্যার জন্য পুনরুদ্ধার সীমাবদ্ধ করুন এবং সেবার নির্দেশনা অনুসরণ করুন।