post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/file
文件上传API，用于上传用户证件或证明文件
接口详情
上传个人验证文件，此接口需针对每个文件单独调用，不支持批量上传。
调用说明
- 请为每一个文件单独调用一次本接口。
- 请求方式：
POST - 请求头：
Content-Type：必须设置为文件的 MIME 类型（如image/jpeg、application/pdf）。- 注意：请勿使用
multipart/form-data格式。
- URL 参数（Query String）：
- 参数
uid、file_name、file_type、file_category需以 Query String 形式附加在 URL 后。
- 参数
- 请求体（Request Body）：
- 直接放入文件的原始二进制内容（Raw Body），不要将其包装在 JSON 或表单字段中。
支持的文件格式
| 类型 | 允许的扩展名 | 允许的 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。 |
如需进一步调整，请随时告知。