Common Responses
All business API responses use the following outer structure:
| Field | Type | Description |
|---|---|---|
code | integer | Response code. 200 indicates success. |
msg | string | Response message. Usually 操作成功 (operation successful) on success. |
data | object/null | Business data. null when no business data is returned. |
Pagination structure:
| Field | Type | Description |
|---|---|---|
items | array | Records on the current page. |
page | integer | Current page number. |
pageSize | integer | Number of records per page. |
total | integer | Total number of records. |
V2 user input validation
Binding and Bean Validation failures in V2 user endpoints return HTTP 400 and body code=400, with the normal platform response signature. This does not redefine other business errors or V1 errors. For example, a missing cardTypeId in the KYC status query returns:
json
{"code":400,"msg":"cardTypeId不能为空","data":null}