link HTTP Response

리스트가 제공하는 지능형 Open API를 호출하면 HTTP 응답 코드로 API의 처리 결과를 반환합니다. 응답 결과 메시지는 JSON 형식으로 반환합니다.

link주요 응답 코드

API 호출이 정상일 경우 응답 코드 값은 200이며, API 호출이 비정상일 경우 응답 코드 값은 400번대와 500번대입니다.
따라서 API 호출이 비정상일 경우에는 아래의 표를 참고하여 응답 코드 값 유형을 확인하신 후 오류 점검을 진행하시면 됩니다.

HTTP Response 결과

리턴 파라미터

HTTP 요청 후 리턴 파라미터를 확인 후 적용합니다.

리턴 파라미터(Return Parameters)
HTTP 리턴 파라미터 파라미터 명 설명
returnParam 응답 코드 200~500 번 대의 결과 상태 코드
message 메시지 요청한 결과에 대한 상태 메지시 처리
resultList 결과 지식베이스 API에 정의 되어 있는 Response key 결과 데이터
응답 코드 값 유형

HTTP 요청 후 반환되는 응답 코드(returnParam) 값 유형입니다.

응답 코드 값 메세지 설명
200 정상 호출 각 API별 JSON 형식의 결과값을 반환합니다.
400 요청 변수 확인 필수 요청 변수가 없거나 요청 변수 이름을 잘못 입력한 경우
400 요청 변수 확인 필수 요청 변수 값을 입력하지 않거나 잘못 입력한 경우
401 인증 실패 Client Key가 없거나 잘못된 값인 경우
404 API 없음 API 요청 URL이 잘못된 경우
500 서버 오류 API 서버 유지 보수나 시스템 오류로 인해 오류가 발생한 경우