본문 바로가기 주메뉴 바로가기

이 누리집은 대한민국 공식 전자정부 누리집입니다.

인문360˚

공공데이터 개방

이용방법

인증키 발급받기

인증키: API 서비스 이용 승낙을 받은 기관 또는 이용자임을 식별할 수 있는 고유 값
인증키를 발급받기 위해서는 먼저 공공데이터포털(www.data.go.kr)에 가입하시기 바랍니다.
아래 이미지에 보이는 화면상의 '활용신청' 버튼을 눌러 인증키를 발급받은 후 프로그램에 데이터 제공 주소(URL)과 오픈API 인증키를 입력한 뒤 API를 호출하면 원하는 데이터를 받을 수 있습니다.

OpenAPI 이용 가이드

OpenAPI 활용 신청 예시

OpenAPI 활용 신청 예시 이미지

1) 요청 변수 (Request Parameter)

요청 변수 목록
요청변수	필수 여부	설명
serviceKey	○	공공데이터포털에서 받은 인증키
pageNo	○	페이지번호
numOfRows	○	한 페이지 결과 수
type	○	데이터타입(xml / json)
keyword	○	조회 키워드 ex)사회

2) 출력 결과 필드 (Response Field)

출력 결과 필드 목록
필드	설명
pageNo	페이지번호
numOfRows	한 페이지 결과 수
totalCount	검색 결과 총 개수
items	배열로 각 item 확인 가능

3) 에러 메시지

,k, f

에러 메시지 목록
오류 코드	설명
00	조회 성공
03	조회 결과 없음
11	조회 조건 필수 parameter 누락
30	등록되지 않은 서비스키
99	알 수 없는 오류