OPEN API

기본정보 - 서비스명, 제공정보, 서비스유형, 일일 허용 요청수, 공개일자, 최신수정일자 , 승인방법, 활용기간, 데이터 제공형태, 기술문서, 요청 URI를 안내하는 표 입니다.
서비스명	공유자원 목록
제공정보	강의실, 회의실, 공간 등 시설정보 등 자원 정보 조회
서비스유형	REST	일일 허용 요청수	1000 건/일
공개일자	2020-10-29	최신수정일자	2023-10-31
승인방법	심의승인	활용기간	승인일로부터 24개월
데이터 제공형태	JSON XML	기술문서	공유누리 API 가이드_v2.2.pdf
요청 URI	https://www.eshare.go.kr/eshare-openapi/rsrc/list/{apikey}

서비스 상세설명 안내표

요청변수 중 자원분류코드(rsrcClsCd)의 값

>> api (자원분류목록)의 응답 중 rsrcClsCd의 값

* 자원분류코드 데이터 목록

* 시도/시군구코드 데이터

행정표준코드시스템(https://www.code.go.kr)의 법정동코드사용

- 시도 코드 : 법정동코드의 앞 1~2자리 숫자 (예시 : 서울특별시 1100000000 => 시도 코드 11)

- 시군구 코드 : 법정동코드의 3~5번째 자리 숫자 (예시 :서울특별시 강남구 1168000000 => 시군구코드 680)

항목명(국문), 항목명(영문), 데이터타입, 필수여부, 설명, 샘플데이터를 안내하는 표 입니다.
항목명(국문)	항목명(영문)	데이터타입	필수여부	설명	샘플데이터
페이지 번호	pageNo	Number	선택	페이지 번호 (Default : 1)	1
한 페이지 결과 수	numOfRows	Number	선택	한 페이지 결과 수 (Default : 10, LimitCnt : 1~100)	100
자원분류코드	rsrcClsCd	String	선택	자원분류코드(6자리코드)	010000
시도 코드	ctpvCd	String	선택	시도 코드	11 (서울특별시)
시군구 코드	sggCd	String	선택	시군구 코드	170 (용산구)
업데이트 범위 시작일	updBgngYmd	String	선택	업데이트 범위 시작일(YYYYMMDD형식)	20200101
업데이트 범위 종료일	updEndYmd	String	선택	업데이트 범위 종료일(YYYYMMDD형식)	20201031

번호, 항목명(국문), 항목명(영문), 설명, 샘플데이터를 안내하는 표 입니다.
항목명(국문)	항목명(영문)	데이터타입	설명	샘플데이터
자원번호	rsrcNo	String	자원번호	ABCDEFG1234
자원명	rsrcNm	String	자원명	자원명
우편번호	zip	String	우편번호	12345
주소	addr	String	주소	서울특별시 용산구 한강대로1번길1
상세주소	daddr	String	상세주소	2동 3호
경도	lot	Number	경도	128.12345
위도	lat	Number	위도	35.12345
해당기관 예약 URL	instUrlAddr	String	해당기관 예약 URL	http://www.eshare.go.kr/..
이미지 URL	imgFileUrlAddr	String	이미지 URL	http://www.eshare.go.kr/..

번호, 코드, 코드메시지, 메시지설명을 안내하는 표 입니다.
번호	코드	코드메시지	메시지설명
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서로 다른 프로토콜을 연결해주는 게이트웨이가 잘못된 프로토콜을 연결하거나 연결된 프로토콜에 문제가 있어 통신이 제대로 되지 않은 상태입니다.

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

전체메뉴