Pilih referensi unggahan yang tidak digunakan
Titik akhir ini menghapus catatan referensi unggahan milik akun Anda. Gunakan hanya jika Anda yakin referensi tersebut tidak lagi diperlukan untuk pelampiran bukti atau pelampiran dokumen pendukung. Tindakan ini tidak menghapus identitas atau alamat pendaftaran.
Dapatkan ID berkas eksternal dari respons unggahan asli atau daftar unggahan yang tersedia. Penangan terlebih dahulu mencari ID tersebut untuk akun Anda, dengan pencarian menggunakan ID penyedia dari sistem lama sebagai alternatif jika tidak ditemukan. Integrasi baru harus menggunakan referensi eksternal persis seperti yang dikembalikan. Isi permintaan tidak diperlukan.
Minta penghapusan secara sadar dan disengaja
Gunakan akun API MultiTEL yang telah diaktifkan melalui HTTPS, dengan kredensial dan pembatasan IP yang dikonfigurasi untuk akun tersebut. Gunakan POST agar aplikasi Anda memperlakukan tindakan ini sebagai perubahan yang disengaja:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefPenangan saat ini tidak memberlakukan pembatasan metode HTTP: permintaan GET juga dapat memicu penghapusan. Jangan sediakan URL ini sebagai tautan biasa yang dapat diklik, gambar, markah, pratinjau, atau sasaran pengambilan data di muka. Wajibkan tindakan penghapusan yang eksplisit dalam aplikasi Anda, dan jangan mencoba ulang secara otomatis.
Pahami hasil dan batasannya
Baca hasil HTTP serta status.code dalam JSON. Respons berhasil yang normal adalah:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Kode API 404 dengan Failed, Not found berarti kedua pencarian tidak menemukan referensi yang cocok untuk akun ini. Karena itu, penghapusan yang diulang dapat mengembalikan 404. Spasi di awal dan akhir nilai jalur dihilangkan. Tidak ada pemeriksaan di sini untuk memastikan bahwa referensi belum kedaluwarsa atau tidak digunakan oleh langkah lain, jadi pastikan alur kerja Anda sebelum menghapusnya.
Penangan melaporkan keberhasilan setelah mencoba menghapus data dari basis data tanpa memeriksa apakah penghapusan tersebut berhasil. Perlakukan respons sebagai hasil yang dilaporkan, bukan bukti independen bahwa data telah dihapus. Jika referensi yang dibuat melalui API dan belum kedaluwarsa sebelumnya terlihat di get_encrypted_files, daftar tersebut dapat membantu memeriksa apakah referensi masih terlihat, tetapi ketidakhadirannya dari daftar juga dapat berarti bahwa referensi telah kedaluwarsa.
Penghapusan ini bukan penghapusan data secara menyeluruh
Penangan mengeluarkan perintah penghapusan pada tabel referensi unggahan. Penangan tidak secara eksplisit menghapus baris konten dokumen yang tersimpan, berkas unggahan lokal, bukti terlampir, identitas, dokumen pendukung, atau salinan yang disimpan penyedia. Perilaku penghapusan berantai dan retensi dalam basis data belum diverifikasi. Jangan jelaskan operasi ini kepada pengguna sebagai penghapusan semua salinan dokumen identitas mereka atau pemenuhan permintaan penghapusan secara menyeluruh.
Setelah referensi lokal dihapus, langkah pelampiran berikutnya yang memerlukannya dapat gagal. Simpan hasil pelampiran yang sudah selesai dan gunakan alur pengelolaan identitas atau bukti yang sesuai saat mengubah informasi pendaftaran yang telah dikirimkan.