공통 응답 구조
| 필드 |
유형 |
설명 |
| code |
Number |
응답의 상태 코드입니다. 아래 예시는 표준 JSON 응답이며, 다운로드 등의 인터페이스는 각 페이지의 설명을 따릅니다. |
| content |
String、Number、Array、Boolean、JSON |
반환되는 데이터이며, 구체적인 데이터 유형은 실제 인터페이스의 비즈니스 로직에 따라 달라집니다. |
| pageInfo |
JSON |
인터페이스에서 페이지네이션을 제공하는 경우 반환되며, 구체적인 계층은 각 인터페이스 설명을 따릅니다. |
| pageInfo.count |
Number |
현재 페이지 데이터 수 |
| pageInfo.pageIndex |
Number |
페이지 번호 |
| pageInfo.pageSize |
Number |
페이지 크기 |
| pageInfo.totalCount |
Number |
조건을 충족하는 총 데이터 수 |
| errorCode |
String |
반환된 오류 상태 코드이며, 비어 있으면 오류가 없음을 의미합니다. |
| message |
String |
반환된 오류 코드에 해당하는 구체적인 설명 정보입니다. |
| success |
Boolean |
인터페이스 성공 여부: 성공 시 true, 실패 시 false |
| traceId |
String |
traceId로, 각 요청 상황을 추적하는 데 사용됩니다. |
요청 JSON 형식 오류 예시
{
"code": 400,
"content": {"reason": "Expecting value", "line": 1, "column": 10},
"errorCode": "ft.RequestJsonFormatError",
"message": "请求 JSON 格式错误",
"success": false,
"traceId": "TRACE-XXXX"
}