列出可用的注册材料上传记录

列出可用的上传引用

在上传注册文件后，如果需要查找仍可用于附加操作的引用，请使用此端点。请通过 HTTPS 使用已启用的 MultiTEL API 账户，并遵循为该账户配置的凭据和 IP 限制。此列表仅涵盖您的账户。

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

无需请求体或查询参数。处理程序列出通过 API 创建、过期标志未设置且过期时间晚于服务器当前时间的上传记录。它不提供分页、搜索或排序参数。此列表并非您账户中所有身份记录、证明材料或历史文件的列表。

读取元数据，而非文件字节内容

读取 HTTP 结果以及 JSON 中的 status.code。成功响应的 response 中包含一个数组；结果为空时返回空数组，而非账户不存在错误。示例使用虚构的元数据和标识符。

{
  "status": {"code": 200, "msg": ""},
  "response": [{
    "id": "0123456789abcdef0123456789abcdef",
    "proof_type": "abcdef0123456789abcdef0123456789",
    "entity_type": "addresses",
    "description": "Example address proof",
    "file_name": "example-document.pdf",
    "date": "2026-10-01 12:00:00"
  }]
}

上传元数据字段
字段	含义
`id`	上传记录的外部引用。请将其原样复制到相应的附加请求中。不要自行计算标识符，也不要用身份记录、地址或模板的标识符替代它。
`proof_type`	已记录的类型引用（经过掩码处理）；若不存在，则为空字符串。对于证明材料上传，这是证明类型；对于支持文件上传，其模板引用也记录在同一个键下。请读取 entity_type 来区分两者。它不是上传标识符。
`entity_type`	已记录的附加类别，例如 identities、addresses 或 supporting_documents。请选择与之匹配的附加工作流程。
`description`	已存储的上传描述。
`file_name`	原始文件名。这不是下载网址。
`date`	已记录的创建时间，由服务器格式化，不含时区偏移量。

响应不包含文件字节内容、存储网址或到期时间。请保留原始上传响应中的 expired_at。上传记录出现在列表中，并不会延长其有效期、将其附加到身份记录，也不能证明运营商已批准该上传文件。

在引用过期前完成附加

请使用适当的证明材料附加或支持文件附加工作流程。当前上传工作流程为引用设置的有效期较短；不要仅仅因为引用出现在此列表中就推迟附加操作。从获取列表到执行附加操作之间，引用可能过期或变得不可用。请根据附加操作的响应进行处理，不要直接假定操作成功。

如果列表意外为空，请检查账户，并确认上传记录是否已过期或是通过其他工作流程创建的。在检查原始上传和附加操作的结果之前，不要自动再次上传相同文件。

隐私

即使不包含文件内容，文件名和描述仍可能识别出个人或文件。请限制访问权限，并避免在日志中记录完整响应。要移除未使用的本地上传引用，请参阅移除上传引用；该操作并不是全面的文件清除服务。