Розробникам

GET/v3/delete_document/{uuid}

Видалення реєстраційного профілю

Ознайомтеся із застарілою операцією видалення та перевірте її обмежений результат.

На цій сторінці
  1. Видаляйте реєстраційний профіль усвідомлено
  2. Застарілий запит із видаленням даних
  3. Повідомлений результат
  4. Перевірте видалення та його обсяг

Видаляйте реєстраційний профіль усвідомлено

Ця застаріла операція намагається видалити ідентифікаційний запис та адресу в оператора зв’язку, що належать обліковому запису, а потім позначає локальний профіль як видалений. Визначте UUID потрібного локального профілю за допомогою documents та перегляньте його на порталі перед викликом цієї операції. Вона не обмежується видаленням підтвердного документа й не є операцією скасування попередньої дії.

Застарілий запит із видаленням даних

Виконайте автентифікацію за допомогою свого активованого облікового запису MultiTEL API з дозволеної IP-адреси. У прикладах використовуються облікові дані зі змінних середовища та вигадані дані. Перевіряйте поля status.code і status.msg у JSON, а також відповідь HTTP.

Поточний портал викликає цю операцію за допомогою GET. Попри використаний метод HTTP, вона змінює дані. Ніколи не використовуйте цю URL-адресу в посиланні, зображенні, перевірці працездатності, попередньому завантаженні браузером, вебсканері чи автоматичній повторній спробі. У своїй інтеграції вимагайте явного рішення користувача про видалення.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID — це ідентифікатор локального профілю, який повертається як uuid під час створення або як id під час зчитування профілю. Це не ідентифікатор ідентифікаційного запису, не ідентифікатор адреси й не номер телефону. Тіло запиту не використовується.

Повідомлений результат

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

Код API 404 з повідомленням Failed, Not found означає, що UUID профілю не знайдено для цього облікового запису. Повідомлений код 200 означає, що обробник дійшов до відповіді про завершення; це не доводить, що оператор зв’язку видалив ідентифікаційний запис та адресу або що оновлення локальної бази даних було успішним.

Перевірте видалення та його обсяг

Поточний обробник не перевіряє результати видалення в оператора зв’язку чи локального оновлення. Після повідомлення про успіх переконайтеся, що профіль відсутній серед активних записів у результатах documents і що відповідь на запит get_document повідомляє, що профіль не знайдено. Ці перевірки встановлюють лише локальну видимість. Вони не доводять видалення в оператора зв’язку вищого рівня.

Ця кінцева точка не є універсальним API для стирання персональних даних. Вона не підтверджує видалення завантажених файлів, підтвердних матеріалів, супровідних документів, журналів, резервних копій чи інших збережених записів. Щоб отримати підтвердження видалення в оператора вищого рівня або подати запит на стирання даних, зверніться до служби підтримки. Не викликайте видалення повторно замість перевірки часткового результату.