আমি একটি RESTful এপিআই ডিজাইন করছি এবং শিরোনাম সমস্যার মুখোমুখি, স্পষ্টতার জন্য পুনরায় সেট করা:
যদি কোনও ক্লায়েন্ট একটি অপরিচিত পরামিতি প্রেরণ করে তবে আমার কী দ্রুত ব্যর্থ হওয়া উচিত? উদাহরণ স্বরূপ,
http://example.com/api/foo?bar=true&paula=bean
উপরের দিকে, bar
একটি বৈধ প্যারামিটার তবে paula
এপিআই দ্বারা নির্দিষ্ট করা হয়নি। আমি কি
- ত্রুটির ক্লায়েন্টকে সতর্ক করুন
- দ্রুত ব্যর্থ
- বাদ দাও
যদি আমি ক্লায়েন্টকে সতর্ক করি তবে আমি কেবলমাত্র প্রথম প্যারামিটারের জন্য একটি সতর্কতা জারি করতে পারি, যেহেতু তারা তাদের নিকট-অসীম সংখ্যাকে প্রেরণ করতে পারে এবং সম্ভবত সার্ভারের আরও ভাল জিনিস করা উচিত। একইভাবে, ব্যর্থ হওয়ার সময়, এটি কেবল প্রথম অবৈধ পরমকে সমস্যা হিসাবে নির্দিষ্ট করে।
আমি প্রোগ্রামারকে পদক্ষেপ নিতে বাধ্য করার জন্য একটি সতর্কতা জারি করার ক্ষেত্রে ব্যর্থতা পছন্দ করি, কারণ তারা অন্যথায় সমস্যাটিকে উপেক্ষা করতে পারে এবং সংস্থানগুলি নষ্ট করে রাখতে পারে, বা অজান্তে নিজেকে কার্গো-কাল্ট করাতে পারে। কিছুই না করা এই সম্মানের ক্ষেত্রে আরও খারাপ।
আমার যুক্তি কি বোধগম্য? এই জাতীয় জিনিসগুলির জন্য কোনও গ্রহণযোগ্য অনুশীলন আছে?
api/v1
ইত্যাদি ব্যবহার করা এটির যত্ন নেবে তবে এটি এখনও বর্ধিত আপডেটের অনুমতি দেয় না। +1