该接口用于在企业KYB流程中上传各类证明文件。支持上传代表人和实际受益人的身份证明、自拍照、居住证明，以及企业的各类合规文档。上传成功后返回文件唯一标识，用于后续在添加或修改代表人、受益人、企业文档时关联文件。
| 参数名 | 类型 | 必填 | 说明 |
|---|
| uid | string | 是 | 用户ID，用于标识当前操作的企业用户 |
| file_type | string | 是 | 文件类型，详见下方分类说明 |
| file | file | 是 | 二进制文件，支持格式：PDF、JPG、JPEG、PNG等 |
| 文件类型 | 说明 |
|---|
institution_rep_passport | 代表人护照 |
institution_rep_dl_front | 代表人驾照正面 |
institution_rep_dl_back | 代表人驾照反面 |
institution_rep_selfie | 代表人自拍照 |
institution_rep_residence | 代表人居住证明 |
institution_rep_id_card_front | 代表人身份证正面 |
institution_rep_id_card_back | 代表人身份证反面 |
institution_rep_residence_permit_front | 代表人居留许可正面 |
institution_rep_residence_permit_back | 代表人居留许可反面 |
| 文件类型 | 说明 |
|---|
institution_bo_passport | 受益人护照 |
institution_bo_dl_front | 受益人驾照正面 |
institution_bo_dl_back | 受益人驾照反面 |
institution_bo_selfie | 受益人自拍照 |
institution_bo_residence | 受益人居住证明 |
institution_bo_id_card_front | 受益人身份证正面 |
institution_bo_id_card_back | 受益人身份证反面 |
institution_bo_residence_permit_front | 受益人居留许可正面 |
institution_bo_residence_permit_back | 受益人居留许可反面 |
| 文件类型 | 说明 |
|---|
institution_doc_certification | 机构认证文件（注册证书等） |
institution_doc_agreement | 协议文件（股东协议等） |
institution_doc_organization | 组织文件（公司章程等） |
institution_doc_residence | 机构居住证明（地址证明等） |
institution_doc_policy | 政策文件（AML政策等） |
institution_doc_authority | 授权文件（董事会决议等） |
institution_doc_fund | 资金来源证明 |
institution_doc_additional | 补充文件 |
curl --location --request POST 'https://sandboxapi.legendtrading.com/v2/app/kyc/entity/file' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN' \
--header 'user-ip: 192.168.1.100' \
--form 'uid="uid26022412"' \
--form 'file_type="institution_rep_passport"' \
--form 'file=@"/Users/test/Downloads/护照.png"'
{
"request_id": "d5e8b08880bd5709faa52dc61280f595",
"status": "success",
"code": "100000",
"message": "success",
"data": [
{
"file_hash": "cf6802c1439966693b1d5db205f5b7fc"
}
],
"metadata": {}
}
| 字段名 | 类型 | 说明 |
|---|
| file_hash | string | 文件哈希 |
| 文件类型 | 支持格式 | 说明 |
|---|
| 图片 | JPG, JPEG, PNG,Heif,Heic,webp | 清晰可辨，无遮挡 |
| 文档 | PDF | 扫描件清晰，文字可识别 |
| 实体类型 | 文件类型前缀 | 关联接口 |
|---|
| 代表人 | institution_rep_* | /app/kyc/entity/rep |
| 受益人 | institution_bo_* | /app/kyc/entity/bo |
| 企业文档 | institution_doc_* | /app/kyc/entity/documents |
