اپ لوڈ کا غیر استعمال شدہ حوالہ ہٹائیں

اپ لوڈ کا غیر استعمال شدہ حوالہ منتخب کریں

یہ اینڈ پوائنٹ آپ کے اکاؤنٹ سے تعلق رکھنے والے اپ لوڈ کے حوالے کا ریکارڈ ہٹاتا ہے۔ اسے صرف تب استعمال کریں جب آپ کو یقین ہو کہ اب اس حوالے کی ضرورت ان کاموں کے لیے نہیں ہے: ثبوت منسلک کرنا یا معاون دستاویز منسلک کرنا۔ یہ رجسٹریشن کے لیے درج شناخت یا پتا حذف نہیں کرتا۔

فائل کا بیرونی شناخت کنندہ حاصل کرنے کے لیے اپ لوڈ کا اصل جواب یا دستیاب اپ لوڈز کی فہرست سے رجوع کریں۔ درخواست سنبھالنے والا جزو پہلے آپ کے اکاؤنٹ میں اس شناخت کنندہ کو تلاش کرتا ہے؛ اس تلاش میں حوالہ نہ ملنے پر وہ پرانے طریقے کے مطابق فراہم کنندہ کے شناخت کنندہ سے تلاش کرتا ہے۔ نئے انضمامات میں بیرونی حوالہ بالکل اسی صورت میں استعمال کریں جس صورت میں وہ واپس ملا ہو۔ درخواست کے متن کی ضرورت نہیں ہے۔

ہٹانے کی درخواست سوچ سمجھ کر کریں

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 میں دکھائی دیتا تھا، تو یہ فہرست جانچنے میں مدد دے سکتی ہے کہ آیا وہ اب بھی دکھائی دیتا ہے؛ تاہم فہرست میں اس کی عدم موجودگی کا مطلب میعاد ختم ہونا بھی ہو سکتا ہے۔

ہٹانے کا مطلب ڈیٹا کو مکمل طور پر مٹانا نہیں ہے

درخواست سنبھالنے والا جزو اپ لوڈ کے حوالوں کی جدول میں حذف کرنے کا حکم جاری کرتا ہے۔ یہ دستاویز کے محفوظ شدہ مواد کی قطار، مقامی طور پر اپ لوڈ کی گئی فائل، منسلک ثبوت، شناخت، معاون دستاویز یا فراہم کنندہ کے پاس موجود نقل کو صراحتاً حذف نہیں کرتا۔ ڈیٹابیس میں سلسلہ وار حذف ہونے اور ڈیٹا محفوظ رکھنے کے طرزِ عمل کی تصدیق نہیں کی گئی ہے۔ صارفین کے سامنے اس کارروائی کو ان کی شناختی دستاویز کی تمام نقول حذف کرنے یا مکمل طور پر مٹانے کی جامع درخواست پوری کرنے کے طور پر پیش نہ کریں۔

مقامی حوالہ ہٹائے جانے کے بعد، منسلک کرنے کے وہ بعد کے مراحل ناکام ہو سکتے ہیں جنہیں اس کی ضرورت ہو۔ منسلک کرنے کی پہلے سے مکمل شدہ کارروائیوں کے نتائج محفوظ رکھیں، اور جمع کرائی گئی رجسٹریشن کی معلومات بدلتے وقت شناخت یا ثبوت کے انتظام کا متعلقہ طریقۂ کار استعمال کریں۔