• 공유누리에서 제공하는 OPEN API 목록 중 이용하고자 하는 OPEN API 명을 클릭합니다.
• 선택한 OPEN API 상세정보를 확인 후 이용을 원하시면 추가정보 입력 후 하단의 [인증키 발급신청] 버튼을 클릭합니다.
• 인증키 발급은 담당자의 승인과정을 거치며 검토일은 3~5일 정도 소요 됩니다.

기본정보

기본정보 - 서비스명, 제공정보, 서비스유형, 일일 허용 요청수, 공개일자, 최신수정일자 , 승인방법, 활용기간, 데이터 제공형태, 기술문서, 요청 URI를 안내하는 표 입니다.

서비스명	자원 관리기관 정보
제공정보	공유자원 관리기관 정보 조회
서비스유형	REST	일일 허용 요청수	1000 건/일
공개일자	2020-11-03	최신수정일자	2023-10-31
승인방법	심의승인	활용기간	승인일로부터 24개월
데이터 제공형태	JSON XML	기술문서	공유누리 API 가이드_v2.2.pdf
요청 URI	https://www.eshare.go.kr/eshare-openapi/agency/list/{apikey}

서비스 상세설명

서비스 상세설명 안내표

공유자원 관리 기관정보 조회

요청 변수(Request Parameter)

항목명(국문), 항목명(영문), 데이터타입, 필수여부, 설명, 샘플데이터를 안내하는 표 입니다.

항목명(국문)	항목명(영문)	데이터타입	필수여부	설명	샘플데이터
페이지 번호	pageNo	String	선택	페이지 번호	1
한 페이지 결과 수	numOfRows	String	선택	한 페이지 결과 수 (Default : 10, LimitCnt : 1~100)	100

서비스 응답변수

번호, 항목명(국문), 항목명(영문), 설명, 샘플데이터를 안내하는 표 입니다.

항목명(국문)	항목명(영문)	데이터타입	설명	샘플데이터
기관코드	instCd	String	기관코드	AB12346
전체기관명	allInstNm	String	전체기관명	국세청 서울지방국세청 서대문세무서
최하위기관명	lowInstNm	String	최하위기관명	서대문세무서
상위기관코드	upInstCd	String	상위기관코드	AB12340
대표기관코드	rprsInstCd	String	대표기관코드	AB12300
폐지구분	ablYn	String	폐지구분(0: 현존 , 1: 폐지)	0

출력메시지 설명

번호, 코드, 코드메시지, 메시지설명을 안내하는 표 입니다.

번호	코드	코드메시지	메시지설명
1	200	OK	OK
2	400	Bad Request	일반적인 오류\r\n주로 API에 필요한 필수 파라미터와 관련하여 서버가 클라이언트 오류를 감지해 요청을 처리하지 못한 상태입니다.
3	401	Unauthorized	인증 오류 (주로 사용자 토큰과 관련)\r\n해당 리소스에 유효한 인증 자격 증명이 없어 요청에 실패한 상태입니다.
4	403	Forbidden	권한 오류\r\n서버에 요청이 전달되었지만, 권한 때문에 거절된 상태입니다.
5	404	Page Not Found	Page Not Found
6	500	Internal Server Error	시스템 오류\r\n서버 에러를 총칭하는 에러 코드로, 요청을 처리하는 과정에서 서버가 예상하지 못한 상황에 놓인 상태입니다.
7	502	Bad Gateway	시스템 오류\r\n서로 다른 프로토콜을 연결해주는 게이트웨이가 잘못된 프로토콜을 연결하거나 연결된 프로토콜에 문제가 있어 통신이 제대로 되지 않은 상태입니다.

신청정보

필수입력는 필수 입력 항목입니다.

이메일, 플랫폼, 사용처URL을 입력할 수 있는 표 입니다.

필수입력 이메일	@ 직접입력 naver.com gmail.com hanmail.net daum.net nate.com
필수입력 플랫폼	웹 개발 앱 개발 기타
필수입력 사용처URL