একটি অব্যবহৃত আপলোড রেফারেন্স বেছে নিন
এই এন্ডপয়েন্ট আপনার অ্যাকাউন্টের একটি আপলোড রেফারেন্সের রেকর্ড সরায়। কেবল তখনই এটি ব্যবহার করুন, যখন আপনি নিশ্চিত যে রেফারেন্সটি নিচের কাজগুলোর জন্য আর প্রয়োজন নেই: প্রমাণ সংযুক্ত করা অথবা সহায়ক নথি সংযুক্ত করা। এটি নিবন্ধনের পরিচয় বা ঠিকানা মুছে ফেলে না।
ফাইলের বাহ্যিক শনাক্তকারী সংগ্রহ করুন মূল আপলোডের প্রতিক্রিয়া অথবা উপলব্ধ আপলোডের তালিকা থেকে। হ্যান্ডলার প্রথমে আপনার অ্যাকাউন্টের জন্য সেই শনাক্তকারী খোঁজে; না পেলে বিকল্প হিসেবে পুরোনো ব্যবস্থার সরবরাহকারীর শনাক্তকারী দিয়ে খোঁজে। নতুন ইন্টিগ্রেশনে বাহ্যিক রেফারেন্সটি যেভাবে ফেরত দেওয়া হয়েছে, ঠিক সেভাবেই ব্যবহার করা উচিত। অনুরোধের বডি প্রয়োজন নেই।
সচেতন সিদ্ধান্ত নিয়ে সরানোর অনুরোধ করুন
সক্রিয় করা একটি MultiTEL API অ্যাকাউন্টের নির্ধারিত প্রমাণীকরণ তথ্য ও আইপি বিধিনিষেধ মেনে HTTPS-এর মাধ্যমে সেটি ব্যবহার করুন। POST ব্যবহার করুন, যাতে আপনার অ্যাপ্লিকেশন এটিকে সচেতনভাবে করা পরিবর্তন হিসেবে বিবেচনা করে:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefবর্তমান হ্যান্ডলার HTTP পদ্ধতির ওপর কোনো বিধিনিষেধ কার্যকর করে না: GET অনুরোধও মুছে ফেলার কার্যক্রমে পৌঁছাতে পারে। এই ইউআরএলকে সাধারণ ক্লিকযোগ্য লিংক, ছবি, বুকমার্ক, প্রিভিউ বা আগাম ডেটা আনার লক্ষ্য হিসেবে উন্মুক্ত করবেন না। আপনার অ্যাপ্লিকেশনে সরানোর জন্য স্পষ্ট পদক্ষেপ নেওয়া বাধ্যতামূলক করুন এবং স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করবেন না।
ফলাফল ও তার সীমাবদ্ধতা বুঝুন
HTTP ফলাফল এবং JSON-এর status.code উভয়ই পড়ুন। সফল হলে স্বাভাবিক প্রতিক্রিয়া হলো:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}API কোড 404-এর সঙ্গে Failed, Not found থাকলে তার অর্থ, কোনো অনুসন্ধানেই এই অ্যাকাউন্টের জন্য মিলে যাওয়া রেফারেন্স পাওয়া যায়নি। তাই আবার সরানোর অনুরোধ করলে 404 ফেরত আসতে পারে। পাথের মানের শুরু ও শেষের ফাঁকা স্থান বাদ দেওয়া হয়। রেফারেন্সটির মেয়াদ এখনো আছে কি না বা অন্য কোনো ধাপে এটি ব্যবহৃত হচ্ছে কি না, এখানে তা যাচাই করা হয় না; তাই সরানোর আগে আপনার কর্মপ্রবাহ নিশ্চিত করুন।
ডেটাবেস থেকে মুছে ফেলার চেষ্টা করার পর হ্যান্ডলার সফলতার খবর দেয়, কিন্তু মুছে ফেলা সফল হয়েছে কি না তা যাচাই করে না। প্রতিক্রিয়াটিকে জানানো ফলাফল হিসেবে বিবেচনা করুন, মুছে যাওয়ার স্বতন্ত্র প্রমাণ হিসেবে নয়। API দিয়ে তৈরি এমন কোনো রেফারেন্স যার মেয়াদ এখনো শেষ হয়নি, যদি get_encrypted_files-এ দেখা যেত, তবে সেটি এখনো দেখা যাচ্ছে কি না যাচাই করতে ওই তালিকা সাহায্য করতে পারে। তবে তালিকায় না থাকার অর্থ মেয়াদ শেষ হয়ে যাওয়াও হতে পারে।
সরানো মানে সব ডেটা সম্পূর্ণ মুছে ফেলা নয়
হ্যান্ডলার আপলোড রেফারেন্সের টেবিল থেকে মুছে ফেলার নির্দেশ দেয়। এটি সংরক্ষিত নথির বিষয়বস্তুর সারি, স্থানীয়ভাবে আপলোড করা ফাইল, সংযুক্ত প্রমাণ, পরিচয়, সহায়ক নথি বা সরবরাহকারীর কাছে থাকা কপি স্পষ্টভাবে মুছে ফেলে না। ডেটাবেসে সংশ্লিষ্ট রেকর্ডগুলো ধারাবাহিকভাবে মুছে যাওয়া এবং ডেটা সংরক্ষণের আচরণ যাচাই করা হয়নি। ব্যবহারকারীদের কাছে এই কার্যক্রমকে তাঁদের পরিচয়পত্রের সব কপি মুছে ফেলা বা সব ডেটা মুছে ফেলার একটি পূর্ণাঙ্গ অনুরোধ পূরণ করা হিসেবে উপস্থাপন করবেন না।
স্থানীয় রেফারেন্সটি সরানোর পর, পরবর্তী যেসব সংযুক্তির ধাপে সেটি প্রয়োজন, সেগুলো ব্যর্থ হতে পারে। ইতিমধ্যে সম্পন্ন সংযুক্তির ফলাফল সংরক্ষণ করুন এবং জমা দেওয়া নিবন্ধনের তথ্য পরিবর্তন করার সময় প্রাসঙ্গিক পরিচয় বা প্রমাণ ব্যবস্থাপনার কর্মপ্রবাহ ব্যবহার করুন।