আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
লক্ষণ
ডেভেলপার পোর্টাল থেকে SmartDocs ব্যবহার করে লাইভ এপিআই অনুরোধ করার সময় ত্রুটি দেখা দিয়েছে।
ত্রুটির বার্তা
ডেভেলপার পোর্টালে সাধারণত যে ত্রুটিটি দেখা যায় তা হলো “ একটি অভ্যন্তরীণ ত্রুটি ঘটেছে। অনুগ্রহ করে আপনার অনুরোধটি পুনরায় চেষ্টা করুন ”।
সম্ভাব্য কারণসমূহ
ডেভেলপার পোর্টাল যখন ব্যাকএন্ড (স্মার্টডকস প্রক্সি বা প্রকৃত এন্ডপয়েন্ট) থেকে কোনো প্রতিক্রিয়া পেতে ব্যর্থ হয়, তখন এই ত্রুটিটি ঘটতে পারে।
রোগ নির্ণয়
আপনার ব্রাউজারে “ডেভেলপার টুলস” চালু করুন এবং প্রকৃত ত্রুটি শনাক্ত করতে নেটওয়ার্ক ট্যাবটি পরীক্ষা করুন।
সাধারণ ত্রুটি এবং সেগুলোর সাধারণ কারণগুলো নিম্নলিখিত সারণিতে তালিকাভুক্ত করা হলো:
ত্রুটি | সাধারণ কারণ(গুলি) |
ERR_NAME_NOT_RESOLVED | SmartDocs প্রক্সি ভুলভাবে কনফিগার করা হয়েছে অথবা নেটওয়ার্ক ফায়ারওয়ালের সীমাবদ্ধতা |
মিশ্র বিষয়বস্তু | পোর্টালটি HTTPs-এর মাধ্যমে কনফিগার করা হয়েছে, SmartDocs-এর অনুরোধ HTTP-এর মাধ্যমে পাঠানো হয়েছে। |
৫০০ - অভ্যন্তরীণ সার্ভার ত্রুটি |
চলুন, এই কারণগুলো এবং সমস্যা সমাধানের পদক্ষেপগুলো এক এক করে আলোচনা করা যাক।
SmartDocs প্রক্সি ভুলভাবে কনফিগার করা হয়েছে অথবা নেটওয়ার্ক ফায়ারওয়ালের সীমাবদ্ধতা
“ ERR_NAME_NOT_RESOLVED ” বার্তাটি নির্দেশ করে যে স্মার্টডকস প্রক্সি ইউআরএলটি ভুলভাবে কনফিগার করা হয়েছে অথবা ফায়ারওয়ালের সীমাবদ্ধতার কারণে যে নেটওয়ার্ক থেকে পোর্টালটি অ্যাক্সেস করা হচ্ছে, সেটি স্মার্টডকস প্রক্সি ইউআরএল-এ কল করতে পারছে না। স্মার্টডকস প্রক্সিটি অবশ্যই ইন্টারনেট থেকে অথবা অভ্যন্তরীণ নেটওয়ার্ক থেকে (অভ্যন্তরীণ এপিআই-এর জন্য) অ্যাক্সেসযোগ্য হতে হবে।
সমাধান
ইন্টারনেট থেকে অ্যাক্সেসযোগ্য একটি হোস্টনেম সহ Edge-এর একটি ভার্চুয়াল হোস্টে smartdocs প্রক্সিটি স্থাপন করে, এটি যেন সমস্ত প্রয়োজনীয় নেটওয়ার্ক থেকে অ্যাক্সেসযোগ্য হয় তা নিশ্চিত করুন।
পোর্টালটি HTTPS-এর মাধ্যমে কনফিগার করা হয়েছে, SmartDocs-এর অনুরোধ HTTP-এর মাধ্যমে পাঠানো হচ্ছে।
“ মিক্সড কন্টেন্ট ” ত্রুটিটি নির্দেশ করে যে, HTTPS-এর মাধ্যমে লোড হওয়া একটি পৃষ্ঠা থেকে HTTP-এর মাধ্যমে স্মার্টডকস প্রক্সিকে কল করা হচ্ছে।
সমাধান
সমস্যাটি সমাধান করতে স্মার্টডকস প্রক্সিকে https-এর মাধ্যমে উন্মুক্ত করুন। এটি করার জন্য, স্মার্টডকস প্রক্সিটি এমনভাবে স্থাপন করতে হবে যাতে TLS/SSL ব্যবহার করার জন্য কনফিগার করা একটি ভার্চুয়াল হোস্ট (সাধারণত “সিকিউর” ভার্চুয়াল হোস্ট) অন্তর্ভুক্ত থাকে।
SmartDocs প্রক্সি একটি ব্যতিক্রম ফেরত দিচ্ছে
500 - ইন্টারনাল সার্ভার এরর বার্তাটি “smartdocs” প্রক্সির কোনো সমস্যার কারণে হতে পারে। এক্ষেত্রে, আপনি লক্ষ্য করবেন যে smartdocs প্রক্সি এই এররটি রিটার্ন করছে।
রোগ নির্ণয়
নিচে বর্ণিত পদ্ধতি অনুযায়ী “smartdocs” প্রক্সির ত্রুটি নির্ণয় করতে ট্রেস টুলটি ব্যবহার করুন। আরও তথ্যের জন্য, “ট্রেস টুলের ব্যবহার ” দেখুন।
- যে নির্দিষ্ট পলিসিটি 500 ইন্টারনাল সার্ভার এরর দিচ্ছে, সেটি খুঁজে বের করার জন্য “ VALIDATE ” অর্গে “ smartdocs ” প্রক্সির জন্য ট্রেস চালু করুন।
- ত্রুটির কারণ শনাক্ত করতে ট্রেস থেকে নির্দিষ্ট পলিসিটি নির্বাচন করুন।
সমাধান
শনাক্তকৃত ত্রুটিটি সমাধান করুন। আপনার সাহায্যের প্রয়োজন হলে, Apigee Edge Support-এর সাথে যোগাযোগ করুন।
এজ মেসেজ প্রসেসরগুলি প্রকাশিত এপিআই এন্ডপয়েন্ট কল করতে অক্ষম
500 - ইন্টারনাল সার্ভার এরর তখনো ঘটতে পারে যখন স্মার্টডকস প্রক্সি হোস্টকারী সংস্থার মেসেজ প্রসেসরগুলো এপিআই এন্ডপয়েন্টকে কল করতে অক্ষম হয়।
রোগ নির্ণয়
নিচে বর্ণিত পদ্ধতি অনুযায়ী “smartdocs” প্রক্সির ত্রুটি নির্ণয় করতে ট্রেস টুলটি ব্যবহার করুন। আরও তথ্যের জন্য, “ট্রেস টুলের ব্যবহার ” দেখুন।
- যে নির্দিষ্ট পলিসিটি 500 ইন্টারনাল সার্ভার এরর দিচ্ছে, সেটি খুঁজে বের করার জন্য “ VALIDATE ” অর্গে “ smartdocs ” প্রক্সির জন্য ট্রেস চালু করুন।
- উপরে দেখানো নমুনা UI ট্রেসে দেখা যাচ্ছে যে, “ BuildTargetAPIRequest ” নামক জাভাস্ক্রিপ্ট পলিসিটি টার্গেট URL-টি এক্সিকিউট করতে ব্যর্থ হচ্ছে।
- “ BuildTargetAPIRequest ” জাভাস্ক্রিপ্ট পলিসি থেকে টার্গেট URL-টি সংগ্রহ করুন।
- নীচে দেখানো অনুযায়ী “ VALIDATE ” org-এর সাথে যুক্ত মেসেজ প্রসেসর নোডগুলি থেকে URL-টিতে সরাসরি কল করুন:
curl -v <target URL>
- যেকোনো পরিলক্ষিত ত্রুটি সংশোধন করুন।
সমাধান
- ডেভেলপার পোর্টালে প্রকাশিত API-গুলো যেন “ VALIDATE ” অর্গের সাথে যুক্ত মেসেজ প্রসেসরগুলো থেকে কল করা যায়, তা নিশ্চিত করুন এবং উদ্ভূত যেকোনো ত্রুটি সংশোধন করুন।
- যদি আপনি মেসেজ প্রসেসর থেকে সরাসরি এপিআই কলটি চালাতে পারেন, তাহলে খুব সম্ভবত আপনি স্মার্টডকস-এর মাধ্যমেও এপিআইটি চালাতে পারবেন।
- SmartDocs-এর মাধ্যমে API কলটি চালান এবং পরীক্ষা করে দেখুন সমস্যাটি সমাধান হয়েছে কিনা।