选择不再使用的上传引用
此端点会移除属于您账户的上传引用记录。仅当您确定以下操作不再需要该引用时才使用此端点:附加证明材料或附加补充文档。它不会删除注册身份记录或地址。
请从最初的上传响应或可用上传列表中获取外部文件标识符。处理程序首先在您的账户下查找该标识符,未找到时会回退到旧版提供商标识符进行查找。新的集成应原样使用返回的外部引用。无需请求正文。
明确发起移除请求
通过 HTTPS 使用已启用的 MultiTEL API 账户,并遵循为该账户配置的凭据和网络地址限制。使用 POST,以便您的应用将此操作视为有意执行的变更:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef当前处理程序不强制限制 HTTP 方法:GET 请求也可能触发删除。请勿将此网址作为普通的可点击链接、图片、书签、预览或预取目标提供。在应用中要求用户明确执行移除操作,且不要自动重试。
理解结果及其局限
请同时读取 HTTP 结果和 JSON 中的 status.code。正常的成功响应如下:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}API 代码 404 且消息为 Failed, Not found,表示两次查找均未找到属于此账户的匹配引用。因此,重复执行移除可能返回 404。路径值首尾的空格会被去除。此处不会检查引用是否尚未过期,也不会检查其他步骤是否正在使用它,因此请在移除前确认您的工作流程。
处理程序在尝试从数据库删除后便报告成功,并不检查删除是否成功。请将响应视为所报告的结果,而非已擦除数据的独立证明。如果通过 API 创建且尚未过期的引用之前可在 get_encrypted_files 中看到,则可以借助该列表检查它是否仍然可见,但列表中不再显示该引用也可能意味着它已过期。
移除不等于彻底擦除数据
处理程序对上传引用表发出删除指令。它不会显式删除已存储的文档内容数据行、本地上传文件、已附加的证明材料、身份记录、补充文档或提供商持有的副本。数据库级联操作和数据保留行为尚未核实。请勿向用户宣称此操作会删除其身份证明文档的所有副本,或满足全面擦除数据的请求。
本地引用一旦移除,后续需要该引用的附加步骤可能会失败。请保留已完成的附加操作结果,并在更改已提交的注册信息时,使用相应的身份或证明材料管理工作流程。