post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/file
文件上传API，用于上传用户证件或证明文件
接口详情
上传个人验证文件，此接口需针对每个文件单独调用，不支持批量上传。
调用说明
- 请为每一个文件单独调用一次本接口。
- 请求方式：
POST，使用multipart/form-data上传。 - 文件内容：放在表单字段
raw_body中，作为真实的文件上传——不是 base64 字符串，也不是裸二进制请求体。 - 其余参数：
uid、file_name、file_type、file_category以表单字段或 Query String 形式传递均可；其中uid、file_name、file_type必填，file_category可选（仅 PoA 类文件使用）。
支持的文件格式
| 类型 | 允许的扩展名 | 允许的 MIME 类型 |
|---|---|---|
| 图片 | jpeg, jpg, png, bmp, tiff, heif, heic, webp | image/jpeg, image/jpg, image/png, image/bmp, image/tiff, image/heif, image/heic, image/webp |
| 文档 | application/pdf |
文件大小限制
- PDF 文件：最大不得超过 20 MB。
- 图片文件：最大不得超过 17 MB。
多次上传规则
同一 file_type 允许重复上传。系统将保留最后一次上传的文件，并自动覆盖此前上传的同类型文件。
请按以下要求上传文件
- 驾照与身份证：必须同时上传正面与背面，文件格式须为图片，不接受 PDF。
- 护照、居住证明及地址证明：仅需上传正面，文件格式须为图片。
- 本人自拍照：仅需上传正面清晰照片。
- 居住地址证明：可上传图片或 PDF 格式的文件。
file_type 类型定义
| 参数 Key | 是否必填 | 说明 |
|---|---|---|
| id_file | 是 | 身份证件正面（如护照、身份证、居留证或驾照）。仅支持图片格式，不接受 PDF。 |
| id_back_file | 是 | 身份证件背面（如身份证背面、驾照背面）。护照无背面，此项可选。仅支持图片格式，不接受 PDF。 |
| selfie_file | 是 | 本人自拍照。需露出完整面部，请勿佩戴眼镜等遮挡物。照片需光线充足、对焦清晰。 |
| proof_of_address | 是（方案二不支持，见下） | 地址证明文件（如水电煤账单）。支持 JPG、JPEG、PNG 及 PDF 格式。如有可用类别，请指定 file_category。 |
走 SDK v2 流程的用户，不能用本接口传地址证明。
如果您在
POST /kyc/individual/pi里传了kyc_flow=kyc_sdk_v2（也就是 方案二），那么：
- 用
file_type=proof_of_address调本接口会失败，返回错误码303124；- 这类用户的地址证明由 SDK 自己收集——SDK 里会先让用户用 GPS 定位验证地址，不通过时再引导用户在 SDK 内上传文件。您不需要、也无法从后端代传。
- 只有
id_file、id_back_file、selfie_file这三类证件文件不受影响，仍可正常上传。方案一（默认的
kyc_connect）和方案三（Sumsub Token Sharing）没有这个限制，proof_of_address照常上传。