附加身份或地址证明

请在身份或地址已存在，且已通过以下接口上传所需文件后执行此步骤：create_encrypt_files，上传时须使用所选的证明类型。请从以下接口获取当前有效的标识符：get_proof_types，并确保它符合相关要求及实体类别。

请保留 identity_id 和 address_id，它们由以下接口返回：create_document；档案的 UUID 与它们不同。对于新建档案，后续附加地址证明的兼容性仍在审查中。如果地址被拒绝，请先在门户中查看或联系支持团队，再重试。

创建证明

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

请求字段
字段	含义
`entity_type`	使用 identities 或 addresses。请选择同时与目标身份或地址及已上传文件相匹配的类别。
`entity_id`	归属于您账户的身份或地址的标识符。请使用文档工作流程返回的标识符，不要用电话号码或无关文档的标识符替代。
`proof_type_id`	所选证明类型的标识符。请确保它与上传时使用的类型及相关要求保持一致。
`encrypted_file_ids`	文件标识符组成的非空 JSON 数组，这些标识符由 create_encrypt_files 返回。文件必须属于同一账户、尚未过期，且与实体类别匹配。这不是本地文件路径列表。

也接受表单数据，其中可重复提交 encrypted_file_ids[] 字段。请优先使用真正的 JSON 数组或表单数组；不要将经过 JSON 编码的数组作为普通的标量表单值发送。

保留证明标识符

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

成功响应表示证明关联已创建。这并不表示身份或地址已获批准、已通过该国家所有要求的验证，或电话号码已激活。

错误和已过期的上传文件

API 代码 500 用于表示缺少必需输入、运营商故障以及运营商响应无效。代码 404 用于以下情况：目标身份或地址未关联到当前账户、证明类型无效、找不到属于此账户及类别的上传文件或该文件已过期，或者已无可用的文件标识符。请阅读 status.msg，并结合代码一起查看。

对于已过期的必需文件，请先使用正确的证明类别重新上传，再将其附加。如果提供的任何文件无效，此处理程序会在发送证明创建请求之前停止。此接口未提供幂等键：请求超时后，请先在门户中检查现有文档，再次执行附加操作。