上传注册证明文件

先上传，再关联

上传同一证明类别或辅助文档类别的文件，然后使用 create_proof 或 create_supporting_document 关联返回的文件 ID。仅上传文件不会创建身份、地址或证明记录，也不会完成号码注册。请先查看当前的要求，并获取目录中的 ID。

必须且只能提供一个选择参数：proof_type_id 用于身份/地址证明，或 supporting_template_id 用于辅助文档。不要同时发送这两个参数。请使用相应 MultiTEL 目录返回的 ID；应将它们视为不透明标识符，不要解读其内部结构。

上传请求

使用已启用的 MultiTEL API 账户及该账户获准使用的 IP 地址。示例使用环境变量中的 HTTP Basic 身份验证凭据；请遵循适用于您账户类型的身份验证规则。通过 HTTPS 发送请求。同时检查 HTTP 响应和 JSON 中的 status.code；应用程序错误也可能伴随 HTTP 200 返回。以下示例均为虚构。

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

文件限制

此处理程序最多接受五个文件，总大小不得超过 20,000,000 字节。这是十进制字节上限，并非 20 MiB。基础设施或 MIME 验证可能施加额外限制。

允许的扩展名包括 pdf、png、jpg、jpeg、gif、tiff、bmp、doc、docx、xls、xlsx、txt、rtf 和 csv。扩展名获准使用并不意味着文件符合所选注册要求。特别注意，tif 不在此允许列表中。

检查每个返回的文件

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

请保留每个 response.ids[].id，供关联请求使用。name 表示返回的原始文件名。请使用互不相同的文件名，并将返回的文件与预期文件集合逐一核对：代码 200 也可能表示批量上传仅部分成功。不要关联缺少必需文件的文件集合。

entity_type 的取值为 identities 或 addresses（上传证明文件时），或 supporting_documents（上传辅助文件时）。document_category 的取值为 proof 或 supporting。名称较为通用的 proof_type 响应字段在上传辅助文件时也会包含模板引用；请保留原始 supporting_template_id，供关联时使用。

及时关联

服务将过期时间设为上传文件存入本地后约 20 分钟。关联时会检查文件是否属于同一账户、是否未被标记为已过期、是否仍未到过期时间，以及实体类别是否正确。expired_at 在此响应中不含时区偏移量；不要假定它采用 UTC。请及时关联，不要将操作安排在即将过期的时间点。

上传引用到期并不代表服务承诺在该时间删除所有已存储的文档副本。服务会为上传至运营商而加密文件，并为文档工作流程保留原始字节；不要将其视为仅在客户端进行的加密或不保留数据的服务。不要在公开日志中记录 ID、文件名和响应。

错误与重试

当前处理程序在未提供任何文档文件时使用 API 代码 404；对于描述验证问题、选择参数缺失或冲突、证明/模板 ID 无效、文件数量或总大小超限、存储问题或上传失败，则使用代码 500。请读取 status.msg；无效输入并非一律以代码 400 表示。

此接口不提供客户端幂等键。如果响应丢失，请先检查文档工作流程，再决定是否重复上传；再次请求可能会创建新的文件引用。这些示例尚未使用客户身份文档进行实际测试。