콘텐츠로 이동

공통 응답 구조


필드 유형 설명
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"
}

문서 평가

이 페이지가 도움이 되었나요?