公共响应
所有业务接口响应体使用以下外层结构:
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 响应码。成功为 200。 |
msg | string | 响应信息。成功通常为 操作成功。 |
data | object/null | 业务数据。无业务数据时为 null。 |
分页数据结构:
| 字段 | 类型 | 说明 |
|---|---|---|
items | array | 当前页数据列表。 |
page | integer | 当前页码。 |
pageSize | integer | 每页数量。 |
total | integer | 总数。 |
V2 用户接口参数校验
V2 用户接口的参数绑定和 Bean Validation 失败返回 HTTP 400、正文 code=400,并保留平台响应签名。不据此推断其他业务错误或 V1 的错误响应。例如 KYC 状态查询缺少 cardTypeId:
json
{"code":400,"msg":"cardTypeId不能为空","data":null}