# 태풍 API 목록 (07-typhoon) - 기상청 API허브

> 기상청 API허브 '태풍' 분류의 API 8개 목록입니다. 항목마다 API 이름(명세 주소 연결), 요청 주소, 설명 순서로 적었습니다.
> 필요한 API 를 고른 뒤 연결된 명세(OpenAPI 3.0.3 yml)를 열면 요청 인자와 응답 형식을 볼 수 있습니다.

- 호출 방법·인증키 안내: https://apihub.kma.go.kr/llms.txt
- 모든 요청은 HTTP GET 이며 인증키를 `authKey` 쿼리 인자로 붙입니다.

## 01-typhoon-info / 01-typhoon-info

- [태풍 목록 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/01-typhoon-info/01-typhoon-info/01-typhoon-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/typ_lst.php` - 지정한 연도에 발생한 태풍의 목록(태풍 번호·이름·발생 소멸 시각·한반도 영향 여부 등)을 조회하는 서비스
- [태풍 정보+예측 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/01-typhoon-info/01-typhoon-info/02-typhoon-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/typ_data.php` - 지정한 연도·태풍 번호·발표번호를 기준으로 태풍의 분석정보와 예측정보를 조회하는 서비스
- [태풍 정보+예측(시점 기준) 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/01-typhoon-info/01-typhoon-info/03-typhoon-forecast-by-issue-time.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/typ_now.php` - 지정한 시각을 기준으로 과거 12시간 이내에 발표된 태풍의 분석정보와 예측정보를 조회하는 서비스

## 01-typhoon-info / 02-typhoon-affecting-korea

- [우리나라에 영향을 미친 태풍 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/01-typhoon-info/02-typhoon-affecting-korea/01-typhoon-affecting-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getTyphoonList` - 지정한 연도에 우리나라에 영향을 미친 태풍의 번호·명칭·발생소멸일·중심최저기압·최대 풍속을 조회하는 서비스

## 02-typhoon-info-td / 01-tropical-depression-info

- [TD 목록 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/02-typhoon-info-td/01-tropical-depression-info/01-td-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/td_lst.php` - 지정한 연도에 발생한 열대저압부(TD)의 목록(TD 번호·연결 태풍 번호·발생 소멸 시각 등)을 조회하는 서비스
- [TD 정보+예측 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/02-typhoon-info-td/01-tropical-depression-info/02-td-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/td_data.php` - 지정한 연도·TD 번호·발표번호를 기준으로 열대저압부의 분석정보와 예측정보를 조회하는 서비스
- [TD 정보+예측(시점 기준) 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/02-typhoon-info-td/01-tropical-depression-info/03-td-forecast-by-issue-time.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/td_now.php` - 지정한 시각을 기준으로 과거 12시간 이내에 발표된 열대저압부의 분석정보와 예측정보를 조회하는 서비스

## 03-typhoon-best-track / 01-best-track

- [태풍 베스트 트랙 조회 서비스](https://apihub.kma.go.kr/specs/07-typhoon/03-typhoon-best-track/01-best-track/01-typhoon-best-track.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/typ_besttrack.php` - 재분석을 거쳐 확정된 사후 태풍 정보(등급·중심위치·중심기압·중심 최대풍속·강풍/폭풍반경 등)를 연도·등급·태풍 호수 기준으로 조회하는 서비스
