Разработчикам

GET/v3/delete_document/{uuid}

Удаление регистрационного профиля

Разберитесь в устаревшей операции удаления данных и проверьте её ограниченный результат.

На этой странице
  1. Удаляйте регистрационный профиль осознанно
  2. Устаревший запрос, удаляющий данные
  3. Результат, сообщаемый API
  4. Проверьте удаление и определите, что оно охватывает

Удаляйте регистрационный профиль осознанно

Эта устаревшая операция пытается удалить у оператора связи идентификационные данные и адрес, принадлежащие учётной записи, а затем помечает локальный профиль как удалённый. Найдите UUID нужного локального профиля с помощью documents и проверьте профиль на портале перед вызовом операции. Эта операция не ограничивается удалением подтверждения и не является операцией отмены.

Устаревший запрос, удаляющий данные

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

В текущей версии портала эта операция вызывается методом 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 при последующем чтении профиля. Это не идентификатор идентификационных данных, не идентификатор адреса и не номер телефона. Тело запроса не используется.

Результат, сообщаемый API

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

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

Проверьте удаление и определите, что оно охватывает

Текущий обработчик не проверяет результаты удаления у оператора связи или локального обновления. После сообщения об успехе убедитесь, что профиль отсутствует среди активных профилей в результатах documents и что ответ о том, что профиль не найден, возвращается при вызове get_document. Эти проверки устанавливают только локальную видимость профиля. Они не доказывают удаление у вышестоящего оператора связи.

Этот эндпоинт не является универсальным API для удаления персональных данных. Его результат не подтверждает удаление загруженных файлов, подтверждений, сопроводительных документов, журналов, резервных копий или других сохраняемых записей. Чтобы подтвердить удаление у вышестоящего оператора связи или подать запрос на удаление данных, обратитесь в службу поддержки. Не заменяйте проверку частичного результата повторными вызовами операции удаления.