উদাহরণগুলিতে অগ্রাধিকারের উপর নির্ভর করার অভ্যাসের কোনও ভুল নেই: আপনার জন্য, আপনার উত্তরটি পাওয়ার এটি কেবল দ্রুততম উপায়। তদুপরি, উদাহরণগুলি চাক্ষুষ। পাঠ্যের অনুচ্ছেদগুলি পড়ার চেয়ে আপনার দৃষ্টিভঙ্গিটি উত্তোলনের চেয়ে দৃষ্টিভঙ্গি উদাহরণ পার্স করা আরও সহজ।
উদাহরণ:
পণ্যগুলি তালিকাভুক্ত করার জন্য, একমাত্র নিয়ন্ত্রকের Index
ক্রিয়া ব্যবহার করা উচিত Products
, এখানে প্রদত্ত GET
একমাত্র সম্ভাব্য ক্রিয়াটি (ডাটাবেস থেকে পণ্যগুলি তৈরি, সংশোধন এবং মুছতে ব্যবহৃত পদক্ষেপগুলি সম্পর্কে আরও তথ্যের জন্য [প্রভাবিত পণ্যগুলি দেখুন] দেখুন)।
কোনও নির্দিষ্ট পণ্য সম্পর্কে বিস্তারিত তথ্য পেতে, ইউআরআইয়ের শেষে এটির অনন্য শনাক্তকারী যুক্ত করুন। আপনি যদি উপলভ্য প্রতিটি পণ্যের তালিকা পেতে চান তবে কিছু যুক্ত করবেন না। আপনি ম্যানুয়ালটির [তথ্য নির্বাচনের জন্য REST ফিল্টার] বিভাগে বর্ণিত ফিল্টারগুলিও ব্যবহার করতে পারেন। নোট করুন যে পণ্যের তালিকা এক হাজার আইটেমের মধ্যে সীমাবদ্ধ। প্রতিটি পৃষ্ঠা এখনও এক হাজার আইটেমের মধ্যে সীমাবদ্ধ থাকা সত্ত্বেও, পুরো তালিকাটি চলার জন্য [পৃষ্ঠায়ণ] ব্যবহার করা যেতে পারে।
আপনি স্টক পরিমাণ পরিমাণ রিফ্রেশ করতে পরিষেবা জোর করতে পারেন। এটি refresh-quantities
একটিকে সেট করে করা হয়।
বিস্তারিত, তবে বিরক্তিকর এবং সবে পঠনযোগ্য। আপনার লিঙ্কগুলি অনুসরণ করা দরকার তা বিষয়গুলিকে আরও খারাপ করে তোলে। আমরা যদি কিছু নমুনা সংযোজন করি তবে এটি বোঝা আরও সহজ হয়ে যায়:
GET পণ্য / সূচক /
জিইটি পণ্য / সূচক / 12345 /
জিইটি পণ্য / সূচক /? এড়ান = 100 & নিন = 20
GET পণ্য / সূচক /? বিভাগ = 12
জিইটি পণ্য / সূচক /? মূল্য = 0..39.90
জিইটি পণ্য / সূচক /? বিভাগ = 12 & লাফালাফি = 100 & নেওয়া = 20
আপনি কেবল উদাহরণগুলি ব্যবহার করেন এমন সমস্যাটি হতে পারে। উদাহরণস্বরূপ উদাহরণগুলি ব্যবহার বন্ধ করবেন না, তবে মনে রাখবেন আপনি একবার ধারণাটি পেয়ে গেলে আরও একটি ভার্বোজ ডকুমেন্টেশন সহায়তা করতে পারে। উদাহরণস্বরূপ, উপরের নমুনাটি দেখায় না যে পণ্যগুলির তালিকা 1 000 এর মধ্যে সীমাবদ্ধ: আপনার জন্য ডকুমেন্টেশন পড়তে হবে।
আপনি কখন জানেন যে আপনার ডকুমেন্টেশনটি পড়া উচিত?
প্রতিবার API বা লাইব্রেরিটি আপনার প্রত্যাশা অনুযায়ী আচরণ করছে না। উদাহরণস্বরূপ, আপনি নমুনাটি ধরুন এবং করুন:
GET পণ্য / সূচক /? এড়ান = 6000 এবং নিন = 3000
কোনও কারণে এটি 3000 এরও কম আইটেম ফেরত দেয়, যখন আপনার ডাটাবেসে বিশ হাজারেরও বেশি পণ্য রয়েছে। এখানে, এপিআই আপনার প্রত্যাশার মতো আচরণ করছে না , তাই বিস্তারিত ডকুমেন্টেশন পড়ার জন্য এটি ভাল সময়।