오픈API 활용가이드 조석예보(고, 저조) 오픈API 활용가이드 서비스 명세 조석예보(고, 저조) 서비스 개요 서비스정보 서비스ID SV-AP-04-006 서비스명(국문) 조석예보(고, 저조) 조회 서비스 서비스명(영문) GetTideFcstHghLwApiService 서비스설명 우리나라 관할해역 조석 예보지점의 검색기준 날짜(1일) 고조, 저조 정보(조위, 시각)를 제공하는 서비스 서비스보안 서비스인증/권한 [ ○ ] 서비스 Key [ ] 인증서 (GPKI) [ ] Basic (ID/PW) [ ] 없음 [ ] WS-Security 메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [ O ] 없음 전송레벨암호화 [ ] SSL[ O ] 없음 적용 기술 수준 인터페이스표준 [ O ] REST (GET, POST, PUT, DELETE) [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML[ O ] JSON[ ] MIME[ ] MTOM 서비스URL 개발환경 https://apis.data.go.kr/1192136/tideFcstHghLw/GetTideFcstHghLwApiService 운영환경 https://apis.data.go.kr/1192136/tideFcstHghLw/GetTideFcstHghLwApiService 서비스WADL 개발환경 N/A 운영환경 N/A 서비스배포 정보 서비스버전 1.0 유효일자 2025-12-12 배포일자 2025-12-12 서비스이력 최초 배포 메시지교환유형 [ O ] Request-Response[ ] Publish-Subscribe [ ] Fire-and-Forgot[ ] Notification 메시지로깅수준 성공 [O] Header [ ] Body 실패 [O] Header [ ] Body 사용제약사항(비고) N/A 조석예보(고, 저조) 코드 정보 코드 구분 코드 코드명 코드 코드명 예보지점 목록 DT_0001 인천 DT_0002 평택 DT_0003 영광 DT_0004 제주 DT_0005 부산 DT_0006 묵호 DT_0007 목포 DT_0008 안산 DT_0010 서귀포 DT_0011 후포 DT_0012 속초 DT_0013 울릉도 DT_0014 통영 DT_0016 여수 DT_0017 대산 DT_0018 군산 DT_0020 울산 DT_0021 추자도 DT_0022 성산포 DT_0023 모슬포 DT_0024 장항 DT_0025 보령 DT_0026 고흥발포 DT_0027 완도 DT_0028 진도 DT_0029 거제도 DT_0031 거문도 DT_0032 강화대교 DT_0035 흑산도 DT_0036 대청도 DT_0037 어청도 DT_0038 굴업도 DT_0039 왕돌초 DT_0040 독도 DT_0041 복사초 DT_0042 교본초 DT_0043 영흥도 DT_0044 영종대교 DT_0046 쌍정초 DT_0047 도농탄 DT_0048 속초등표 DT_0049 광양 DT_0050 태안 DT_0051 서천마량 DT_0052 인천송도 DT_0054 진해 DT_0056 부산항신항 DT_0057 동해항 DT_0058 경인항 DT_0059 백령도 DT_0060 연평도 DT_0061 삼천포 DT_0062 마산 DT_0063 가덕도 DT_0064 교동대교 DT_0065 덕적도 DT_0067 안흥 DT_0068 위도 DT_0091 포항 DT_0092 여호항 DT_0093 소무의도 DT_0094 서거차도 IE_0060 이어도 IE_0061 신안가거초 IE_0062 옹진소청초 SO_0326 미조항 SO_0537 벽파진 SO_0538 안마도 SO_0539 강화외포 SO_0540 호산항 SO_0547 말도 SO_0548 우이도 SO_0549 초도 SO_0550 나로도 SO_0551 여서도 SO_0552 고현항 SO_0553 해운대 SO_0554 영종왕산 SO_0555 서망항 SO_0562 승봉도 SO_0563 울도 SO_0564 국화도 SO_0565 향화도항 SO_0566 송공항 SO_0567 쉬미항 SO_0568 백야도 SO_0569 남포항 SO_0570 광암항 SO_0571 거제외포 SO_0572 읍천항 SO_0573 양포항 SO_0574 백사장항 SO_0576 화봉리 SO_0577 가거도 SO_0578 소매물도 SO_0581 강양항 SO_0631 암태도 SO_0699 천리포항 SO_0700 호도 SO_0701 홍도항 SO_0702 진도옥도 SO_0703 땅끝항 SO_0704 소안항 SO_0705 마량항 SO_0706 청산도 SO_0707 시산항 SO_0708 안도항 SO_0709 두문포 SO_0710 봉우항 SO_0711 창선도 SO_0712 능양항 SO_0731 대진항 SO_0732 남애항 SO_0733 강릉항 SO_0734 궁촌항 SO_0735 죽변항 SO_0736 축산항 SO_0737 강구항 SO_0739 도장항 SO_0740 보옥항 SO_0752 검산항 SO_0753 하의도웅곡 SO_0754 평호리 SO_0755 원동항 SO_0756 사초항 SO_0757 안남리 SO_0758 달천도 SO_0759 장문리 SO_0760 오산항 SO_0761 녹동항 SO_1248 신안옥도 SO_1249 독거도 SO_1250 평도 SO_1251 낙월도 SO_1252 외연도항 SO_1253 상왕등도 SO_1254 만재도 SO_1255 상태도 SO_1256 어류정항 SO_1257 강화하리 SO_1258 잠진도 SO_1259 자월도 SO_1260 방포항 SO_1261 무창포항 SO_1262 격포항 SO_1263 구시포항 SO_1264 계마항 SO_1265 송이도 SO_1266 남열항 SO_1267 구룡포항 SO_1268 궁평항 SO_1269 연도항 SO_1270 삼길포항 SO_1271 어은돌항 SO_1272 다대포항 SO_1273 장호항 SO_1274 거진항 SO_1275 공현진항 SO_1276 아야진항 SO_1277 화순항 SO_1278 원평항 SO_1279 어란진항 SO_1280 덕산항 SO_1281 임원항 SO_1282 선재도 SO_1283 사천진항 SO_1284 월포리 SO_1285 구계항 SO_1286 영덕대진항 SO_1287 구산항 SO_1288 기사문항 SO_1289 삼척항 조석예보(고, 저조) 오퍼레이션 명세 오퍼레이션유형 조회 오퍼레이션명(국문) 조석예보(고, 저조) 조회 API 오퍼레이션명(영문) getTideFcstHghLwApi 오퍼레이션설명 우리나라 관할해역 조석 예보지점의 검색기준 날짜(1일) 고조, 저조 정보(조위, 시각)를 제공하는 기능 Call Back URL N/A 최대메시지사이즈 - 평균응답시간 - 초당최대트랜잭션 - 테이블명 API_EBBF_FRCST_INFO 엔티티명 조석예보 정보 □ 조석예보(고, 저조) 오퍼레이션 요청 메시지 명세 ※ 항목 구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n) 항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명 serviceKey 서비스키 varchar(200) 1 인증키 (URL Encode) 공공데이터포털 발급 인증키 numOfRows 한 페이지 결과 수 number 0 10 한 페이지 결과 수 기본값: 10 최댓값: 300 pageNo 페이지 번호 number 0 1 페이지 번호 기본값: 1 type 데이터 타입 varchar(10) 0 xml 응답 데이터 타입 기본값: xml json 또는 xml obsCode 예보지점 코드 varchar(20) 1 DT_0018 예보지점 코드 reqDate 요청일자 varchar(20) 0 20250809 요청일자 기본값: 현재일자 include 출력 항목 코드 varchar(300) 0 lot, lat 출력하고자 하는 항목명 exclude 출력 제외 항목 코드 varchar(300) 0 lot, lat 출력 제외하고자 하는 항목명 □ 조석예보(고, 저조) 오퍼레이션 응답 메시지 명세 ※ 항목 구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n) 항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명 resultCode 응답 메시지 코드 varchar(2) 1 0 응답 메시지 코드 resultMsg 응답 메시지 내용 varchar(50) 1 NORMAL SERVICE 응답 메시지 내용 totalCount 전체 응답 결과 수 number 1 1000 전체 응답 결과 수 numOfRows 한 페이지 결과 수 number 1 10 한 페이지 결과 수 pageNo 페이지 번호 number 1 1 페이지 번호 type 응답 데이터 타입 varchar(10) 1 json 응답 데이터 타입 items 목록 number 0..n - 정보 목록 obsvtrNm 예보지점명 varchar(200) 0 군산 예보지점명 lot 예보지점 경도 numeric 0 126.563056 예보지점 경도 lat 예보지점 위도 numeric 0 35.975556 예보지점 위도 predcDt 예측일시 timestamp 0 2025-11-11 01:30 예측일시 predcTdlvVl 예측조위값 numeric 0 183.0 예측조위값(cm) extrSe 극치구분 varchar(2) 0 2 극치구분 1 : 오전 고조 2 : 오전 저조 3 : 오후 고조 4 : 오후 저조 □ 요청/응답 메세지 예제 REST(URL) https://apis.data.go.kr/1192136/tideFcstHghLw/GetTideFcstHghLwApiService?obsCode=DT_0018&serviceKey=AMyfd1QSZjfF9P6lRuzR40IrD25Ol7kqGpKRnf6CBRU 응답 메시지
00 NORMAL_SERVICE
군산 126.56305 35.97555 2025-11-26 00:47 190.0 2 1 10 1 xml