นักพัฒนา

POST/v3/delete_encrypted_file/{file_id}

ลบข้อมูลอ้างอิงการอัปโหลดที่ไม่ใช้แล้ว

ลบระเบียนข้อมูลอ้างอิงการอัปโหลดในระบบภายใน โดยแยกให้ชัดเจนจากการลบข้อมูลระบุตัวตนหรือการลบเอกสารอย่างสมบูรณ์

ในหน้านี้
  1. เลือกข้อมูลอ้างอิงการอัปโหลดที่ไม่ใช้แล้ว
  2. ส่งคำขอลบอย่างตั้งใจ
  3. ทำความเข้าใจผลลัพธ์และข้อจำกัด
  4. การลบนี้ไม่ใช่การลบข้อมูลอย่างสมบูรณ์

เลือกข้อมูลอ้างอิงการอัปโหลดที่ไม่ใช้แล้ว

ปลายทางนี้จะลบระเบียนข้อมูลอ้างอิงการอัปโหลดที่เป็นของบัญชีคุณ ใช้เฉพาะเมื่อแน่ใจว่าไม่จำเป็นต้องใช้ข้อมูลอ้างอิงนั้นอีกต่อไปสำหรับ การแนบหลักฐาน หรือ การแนบเอกสารประกอบ โดยจะไม่ลบข้อมูลระบุตัวตนหรือที่อยู่ที่ใช้ลงทะเบียน

รับรหัสไฟล์ภายนอกจาก ผลตอบกลับจากการอัปโหลดครั้งแรก หรือ รายการอัปโหลดที่มีให้ใช้ ตัวจัดการจะค้นหารหัสดังกล่าวสำหรับบัญชีของคุณก่อน หากไม่พบจะค้นหาโดยใช้รหัสของผู้ให้บริการตามกลไกเดิมเป็นทางเลือกสำรอง การเชื่อมต่อระบบใหม่ควรใช้ข้อมูลอ้างอิงภายนอกให้ตรงตามค่าที่ได้รับทุกประการ ไม่ต้องส่งเนื้อหาคำขอ

ส่งคำขอลบอย่างตั้งใจ

ใช้บัญชี API ของ MultiTEL ที่เปิดใช้งานแล้วผ่าน HTTPS พร้อมข้อมูลรับรองและข้อจำกัด IP ที่กำหนดไว้สำหรับบัญชีนั้น ใช้ POST เพื่อให้แอปพลิเคชันของคุณถือว่านี่เป็นการเปลี่ยนแปลงที่ตั้งใจดำเนินการ:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

ตัวจัดการปัจจุบันไม่ได้บังคับใช้ข้อจำกัดด้านเมธอด HTTP: คำขอ GET ก็อาจทำให้เกิดการลบได้เช่นกัน อย่านำ URL นี้ไปใช้เป็นลิงก์ทั่วไปที่คลิกได้ รูปภาพ บุ๊กมาร์ก หรือเป้าหมายสำหรับการแสดงตัวอย่างหรือการดึงข้อมูลล่วงหน้า แอปพลิเคชันของคุณต้องกำหนดให้ผู้ใช้สั่งลบอย่างชัดเจน และต้องไม่ลองส่งคำขอซ้ำโดยอัตโนมัติ

ทำความเข้าใจผลลัพธ์และข้อจำกัด

อ่านทั้งผลลัพธ์ HTTP และค่า status.code ใน JSON ผลตอบกลับเมื่อสำเร็จตามปกติคือ:

{
  "status": {"code": 200, "msg": "Success"},
  "response": []
}

รหัส API 404 พร้อม Failed, Not found หมายความว่าการค้นหาทั้งสองวิธีไม่พบข้อมูลอ้างอิงที่ตรงกันสำหรับบัญชีนี้ ดังนั้นการส่งคำขอลบซ้ำจึงอาจได้รับ 404 ช่องว่างที่ต้นและท้ายค่าในเส้นทางจะถูกตัดออก ในขั้นตอนนี้ไม่มีการตรวจสอบว่าข้อมูลอ้างอิงยังไม่หมดอายุหรือไม่ได้ถูกใช้โดยขั้นตอนอื่น จึงควรตรวจสอบขั้นตอนการทำงานของคุณให้แน่ใจก่อนลบ

ตัวจัดการรายงานว่าสำเร็จหลังจากพยายามลบข้อมูลในฐานข้อมูล โดยไม่ได้ตรวจสอบว่าการลบนั้นสำเร็จหรือไม่ ให้ถือว่าผลตอบกลับเป็นเพียงผลที่ระบบรายงาน ไม่ใช่หลักฐานยืนยันการลบข้อมูลจากการตรวจสอบแยกต่างหาก หากข้อมูลอ้างอิงที่สร้างผ่าน API และยังไม่หมดอายุเคยปรากฏใน get_encrypted_files รายการนั้นอาจช่วยตรวจสอบได้ว่าข้อมูลอ้างอิงยังปรากฏอยู่หรือไม่ แต่การไม่ปรากฏในรายการก็อาจหมายถึงข้อมูลอ้างอิงหมดอายุแล้วเช่นกัน

การลบนี้ไม่ใช่การลบข้อมูลอย่างสมบูรณ์

ตัวจัดการส่งคำสั่งลบไปยังตารางข้อมูลอ้างอิงการอัปโหลด โดยไม่ได้สั่งลบแถวที่เก็บเนื้อหาเอกสาร ไฟล์ที่อัปโหลดไว้ในระบบภายใน หลักฐานที่แนบ ข้อมูลระบุตัวตน เอกสารประกอบ หรือสำเนาที่ผู้ให้บริการเก็บไว้โดยตรง ยังไม่ได้ตรวจสอบพฤติกรรมการลบข้อมูลที่เกี่ยวข้องต่อเนื่องในฐานข้อมูลและการเก็บรักษาข้อมูล อย่าอธิบายการดำเนินการนี้ต่อผู้ใช้ว่าเป็นการลบสำเนาเอกสารยืนยันตัวตนของพวกเขาทั้งหมด หรือเป็นการดำเนินการที่ตอบสนองคำขอลบข้อมูลอย่างครอบคลุม

เมื่อลบข้อมูลอ้างอิงในระบบภายในแล้ว ขั้นตอนการแนบในภายหลังที่ต้องใช้ข้อมูลอ้างอิงนั้นอาจล้มเหลว เก็บผลลัพธ์ของการแนบที่เสร็จสมบูรณ์แล้วไว้ และใช้ขั้นตอนการจัดการข้อมูลระบุตัวตนหรือหลักฐานที่เกี่ยวข้องเมื่อต้องการเปลี่ยนแปลงข้อมูลการลงทะเบียนที่ส่งไปแล้ว