공유누리에서 제공하는 OPEN API 목록 중 이용하고자 하는 OPEN API 명을 클릭합니다. 선택한 OPEN API 상세정보를 확인 후 이용을 원하시면 추가정보 입력 후 하단의 [인증키 발급신청] 버튼을 클릭합니다. 인증키 발급은 담당자의 승인과정을 거치며 검토일은 3~5일 정도 소요 됩니다.
기본정보 기본정보 - 서비스명, 제공정보, 서비스유형, 일일 허용 요청수, 공개일자, 최신수정일자 , 승인방법, 활용기간, 데이터 제공형태, 기술문서, 요청 URI를 안내하는 표 입니다. 서비스명 공유자원 회의실 목록 제공정보 회의실 자원정보 목록 조회 서비스유형 REST 일일 허용 요청수 1000 건/일 공개일자 2020-12-24 최신수정일자 2023-10-31 승인방법 심의승인 활용기간 승인일로부터 24개월 데이터 제공형태 JSON XML 기술문서 공유누리 API 가이드_v2.2.pdf 요청 URI https://www.eshare.go.kr/eshare-openapi/rsrc/list/010100/{apikey}
서비스 상세설명 서비스 상세설명 안내표 회의실 자원정보 목록 조회* 시도/시군구코드 데이터행정표준코드시스템(https://www.code.go.kr)의 법정동코드사용- 시도 코드 : 법정동코드의 앞 1~2자리 숫자 (예시 : 서울특별시 1100000000 => 시도 코드 11)- 시군구 코드 : 법정동코드의 3~5번째 자리 숫자 (예시 :서울특별시 강남구 1168000000 => 시군구코드 680)
요청 변수(Request Parameter) 항목명(국문), 항목명(영문), 데이터타입, 필수여부, 설명, 샘플데이터를 안내하는 표 입니다. 항목명(국문) 항목명(영문) 데이터타입 필수여부 설명 샘플데이터 페이지 번호 pageNo Number 선택 페이지 번호 (Default : 1) 1 한 페이지 결과 수 numOfRows Number 선택 한 페이지 결과 수 (Default : 10, LimitCnt : 1~100) 100 시도 코드 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 String 경도 128.12345 위도 lat String 위도 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서로 다른 프로토콜을 연결해주는 게이트웨이가 잘못된 프로토콜을 연결하거나 연결된 프로토콜에 문제가 있어 통신이 제대로 되지 않은 상태입니다.
신청정보 필수입력는 필수 입력 항목입니다. 이메일, 플랫폼, 사용처URL을 입력할 수 있는 표 입니다. 필수입력 이메일 @ 직접입력 naver.com gmail.com hanmail.net daum.net nate.com 필수입력 플랫폼 웹 개발 앱 개발 기타 필수입력 사용처URL
