删除注册资料

审慎删除注册资料

这项旧版操作会尝试删除该账户所属的运营商身份记录和地址，然后将本地资料标记为已删除。请通过 documents 确定正确的本地资料 UUID，并在门户中核查该资料后再调用此操作。此操作并非仅删除证明材料，也不是撤销操作。

具有破坏性的旧版请求

请从允许的 IP 地址使用已启用的 MultiTEL API 账户进行身份验证。示例使用环境变量中的凭据和虚构数据。除 HTTP 响应外，还须读取 JSON 中的 status.code 和 status.msg。

当前门户使用 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 返回。它不是身份记录 ID、地址 ID 或电话号码。此请求不使用请求体。

返回的结果

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

API 代码为 404 且消息为 Failed, Not found 表示未在此账户下找到该资料 UUID。返回 200 表示处理程序已执行到返回完成响应的步骤；这并不能证明运营商已删除身份记录或地址，也不能证明本地数据库更新成功。

核实删除结果及其范围

当前处理程序不会检查运营商端删除操作或本地更新的结果。收到成功响应后，请确认该资料已不在 documents 返回的有效资料结果中，并且查询该资料时返回未找到，所用接口为 get_document。这些检查只能确认本地可见性，不能证明上游运营商已完成删除。

此端点不是通用的个人数据清除 API。它不能确认已删除上传的文件、证明材料、辅助文件、日志、备份或其他保留记录。如需确认上游删除结果或提出数据清除请求，请联系支持团队。不要通过反复调用删除操作来代替核查仅部分完成的操作结果。