该接口用于在企业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
curl --location --request POST 'https://sandboxapi.legendtrading.com/v2/app/kyb/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"'JSON
{
"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/kyb/rep受益人 institution_bo_*/app/kyb/bo企业文档 institution_doc_*/app/kyb/documents/save
