get
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/fields
返回用户提交KYC需要完成的字段
接口详情
检查字段完成进度,获取Legend Trading要求的个人用户基本信息字段及其完成状态。
参数说明
country_iso2_code 与 uid 参数为二选一必填项,具体使用场景如下:
| 适用场景 | 参数名 | 说明 |
|---|---|---|
| 用户未开始注册 | country_iso2_code | 根据国家/地区代码,返回该地区用户需要填写的全部字段列表 |
| 用户已部分完成 KYC | uid | 根据用户唯一标识,返回该用户尚未完成的必填字段清单 |
如果两个参数都传递了,则以country_iso2_code为准,但是同时也会检查uid是否有效。
API返回值中的特殊字段说明
使用示例
// 场景一:新用户注册
{
"country_iso2_code": "US"
}
// 场景二:已注册用户进度查询
{
"uid": "12345"
}注意事项
1. 居住国变更与字段重验证
当用户的居住国家country_iso2_code信息发生变更时,其必填字段集合可能会相应调整。在此情况下,必须重新调用本接口以获取最新的字段要求,并验证用户资料是否已填写完整。
提示:为确保资料符合最新规范,请在用户更新
country_iso2_code后,触发本接口的重新调用与验证流程。
2. 手机号码字段结构
phone 参数为一个复合对象,包含以下两个子字段:
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
phone_isd_code | String | 是 | 国际区号(例如:86) |
phone_number | String | 是 | 手机号码(不包含区号) |
