Премахнете неизползвана препратка към качен файл

Изберете неизползвана препратка към качен файл

Тази крайна точка премахва запис на препратка към качен файл, който принадлежи на вашия акаунт. Използвайте я само когато сте сигурни, че препратката вече не е необходима за прикачване на доказателство или прикачване на придружаващ документ. Това не изтрива самоличност или адрес за регистрация.

Вземете външния идентификатор на файла от първоначалния отговор при качването или списък с наличните качени файлове. Обработващият компонент първо търси този идентификатор за вашия акаунт, а ако не го намери, използва стария начин за търсене по идентификатор на доставчика. Новите интеграции трябва да използват външната препратка точно както е върната. Не се изисква тяло на заявката.

Заявете премахването съзнателно

Използвайте активиран 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": []
}

Код 404 от API с Failed, Not found означава, че нито едно от двете търсения не е намерило съответстваща препратка за този акаунт. Затова повторното премахване може да върне 404. Интервалите в началото и края на стойността в пътя се премахват. Тук не се проверява дали препратката все още е валидна или дали не се използва от друга стъпка, затова проверете работния си процес, преди да я премахнете.

Обработващият компонент съобщава за успех след опит за изтриване от базата данни, без да проверява дали изтриването е успяло. Приемайте отговора като съобщения резултат, а не като независимо доказателство за изтриване. Ако все още валидна препратка, създадена чрез API, е била видима в get_encrypted_files, този списък може да помогне да проверите дали тя остава видима, но липсата ѝ от списъка може да означава и изтичане на срока ѝ.

Премахването не е пълно изтриване на данните

Обработващият компонент изпраща команда за изтриване от таблицата с препратки към качени файлове. Той не изтрива изрично съхранения ред със съдържанието на документа, локалния качен файл, прикаченото доказателство, самоличността, придружаващия документ или копието, съхранявано от доставчика. Поведението на каскадното изтриване в базата данни и на запазването на данните не е проверено. Не представяйте тази операция на потребителите като изтриване на всички копия на документа им за самоличност или като изпълнение на искане за цялостно изтриване.

След премахването на локалната препратка последващите стъпки за прикачване, които се нуждаят от нея, може да се провалят. Запазете резултатите от вече завършените прикачвания и използвайте съответния работен процес за управление на самоличността или доказателствата, когато променяте подадената информация за регистрация.