- OPEN API
OPEN API 서비스란?
OPEN API는 누구나 사용할 수 있도록 자료를 공유하고, 손쉽게 활용할 수 있도록 지원하는 서비스를 말합니다.
OPEN API 이용절차
-
ONE
기관 또는 개인 신청
-
TWO
심의 및 인증키 발급
-
THREE
서비스 운영
서비스 대상 및 방법
- 대상은 개인과 기관으로 개인은 개인의 신청서를 작성하시고 기관은 기관의 신청서를 작성하셔서 제출하시면 됩니다.
- 개인 및 기관으로 신청서 작성 후 접수가 완료되면 OPEN API를 이용할 수 있습니다.
인증키 발급
- 인증키는 API신청 담당자의 승인 후 신청 이메일을 통해 안내/발급됩니다.
- 발급된 인증키를 통하여 해당 서비스를 개발 계정과 운영 계정에서 활용 할 수 있습니다.
OPEN API 이용 제한
- 상업적 이용이 불가능한 API에 대해 상업적 활용한 경우
- 트래픽 초과로 인해 시스템에 부하가 발생할 경우
- 공공의 목적이 아닌 기타 개인적 혹은 불법적 목적으로 사용하는 경우
이용안내
- 요청주소(JSON) https://sooyusil.com/api/nursingRoomJSON.do(GET)
- 요청주소(XML) https://sooyusil.com/api/nursingRoomXML.do(GET)
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|
| 인증키 | confirmApiKey | 필수 | 7688-D47F-F01C-A395-D595-4203-651D-C001 | 승인 후 신청이메일로 받은 인증키 |
| 수유실 명 | roomName | 옵션 | 코스트코홀세일대전점 | 수유실 명 |
| 주소 | address | 옵션 | 대전 중구 오류로 41 (오류동, 코스트코대전점) | 주소 |
| 광역시/도 | zoneName | 옵션 | 대전 | 광역시/도 명 |
| 시/군/구 | cityName | 옵션 | 중구 | 시/군/구 명 |
| 도로명(번지) | townName | 옵션 | 오류로 | 도로명(번지) |
| 수유실 종류 코드 | roomTypeCode | 옵션 | 3(가족수유실), 4(모유수유/착유실) | 수유실 종류 코드 |
| 아빠 이용 코드 | fatherUseCode | 옵션 | 0 (불가능), 1 (가능) | 아빠 이용 코드 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 상위항목 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|
| 메시지 | message | 응답 메시지 | ||
| 수유실 목록 | roomList | 응답받은 수유실 목록 | ||
| 수유실 | room | roomList | 목록에 존재하는 개별 수유실 | |
| 수유실 번호 | roomNo | room | 1175 | 수유실 번호 |
| 수유실 명 | roomName | room | 코스트코홀세일대전점 | 수유실 명 |
| 시/군/구 | cityName | room | 중구 | 시/군/구 |
| 광역시/도 | zoneName | room | 대전 | 광역시/도 |
| 도로명(번지) | townName | room | 오류로 | 도로명(번지) |
| 수유실 종류 코드 | roomTypeCode | room | 3 | 수유실 종류 코드 |
| 수유실 종류 명 | roomTypeName | room | 가족수유실 | 수유실 종류 명 |
| 관리자 연락처 | managerTelNo | room | 042-539-1052 | 관리자 연락처 |
| 주소 | address | room | 대전 중구 오류로 41 (오류동, 코스트코대전점) | 주소 |
| 상세위치 | location | room | 중층(중간층,지하1층과 1층 사이) | 상세위치 |
| 아빠 이용 코드 | fatherUseCode | room | 1 | 아빠 이용 |
| 아빠 이용 여부 | fatherUseNm | room | 아빠이용가능 | 아빠 이용 여부 |
| 위도 | roomNo | room | 36.32399718999492 | 위도(수유실) |
| 경도 | roomNo | room | 127.40349396434976 | 경도(수유실) |
JSON 응답 예시(JSON Response Image)
XML응답 예시(XML Response Image)
