Виберіть невикористовуване посилання на завантаження
Ця кінцева точка видаляє запис посилання на завантаження, що належить вашому обліковому запису. Використовуйте її лише тоді, коли впевнені, що посилання більше не потрібне для прикріплення підтвердження або прикріплення супровідного документа. Вона не видаляє реєстраційні ідентифікаційні дані чи адресу.
Отримайте зовнішній ідентифікатор файлу з початкової відповіді на завантаження або списку доступних завантажень. Обробник спочатку шукає цей ідентифікатор для вашого облікового запису, а якщо не знаходить, застосовує застарілий спосіб пошуку за ідентифікатором постачальника. Нові інтеграції мають використовувати зовнішнє посилання саме в тому вигляді, у якому його повернуто. Тіло запиту не потрібне.
Надсилайте запит на видалення усвідомлено
Використовуйте активований обліковий запис MultiTEL API через 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, цей список може допомогти перевірити, чи воно досі відображається, але відсутність у списку також може означати закінчення строку дії.
Видалення не є повним стиранням даних
Обробник надсилає команду видалення до таблиці посилань на завантаження. Він явно не видаляє збережений рядок із вмістом документа, локальний завантажений файл, прикріплене підтвердження, ідентифікаційні дані, супровідний документ чи копію, яку зберігає постачальник. Поведінку каскадних операцій бази даних і зберігання даних не перевірено. Не представляйте цю операцію користувачам як видалення всіх копій їхнього документа, що посвідчує особу, або виконання запиту на повне стирання даних.
Після видалення локального посилання подальші етапи прикріплення, яким воно потрібне, можуть завершитися невдало. Збережіть результати вже виконаних прикріплень і використовуйте відповідний процес керування ідентифікаційними даними або підтвердженнями, коли змінюєте подану реєстраційну інформацію.