GET/weather/cyclone/{date}

해당 API는 위도(latitude), 경도(longitude), 날짜 정보를 입력하여 특정 위치의 기상 예보 데이터를 조회할 수 있는 기능을 제공합니다.

입력된 날짜를 기준으로 최대 4일 전부터 15일 후까지의 예보 데이터를 조회하실 수 있습니다.

인증 방법

본 API는 Swagger UI를 기반으로 한 Basic 인증 방식을 사용합니다.

인증 절차

Swagger 문서에 접속합니다.

우측 상단의 [Authorize] 버튼을 클릭합니다.

제공된 아이디와 비밀번호를 입력합니다.

[Authorize] 버튼을 클릭하여 인증을 진행합니다.

인증 완료 후 [Close] 버튼을 클릭하여 창을 닫습니다.

인증이 완료되면, Swagger UI를 통해 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함됩니다.

요청 정보

1. 요청 URL

bash
복사편집
[GET] https://insight.seavantage.com/api/weather/forecast/{date}

Plain Text
복사

2. 실행 절차

Swagger 문서에서 우측 상단 Select a definition 메뉴에서 Weather를 선택합니다.

/weather/forecast/{date} 경로를 선택합니다.

[Try it Out] 버튼을 클릭하여 요청 필드를 활성화합니다.

아래와 같이 요청 파라미터를 입력합니다.

파라미터	설명	예시
longitude	경도	65.593025
latitude	위도	23.55944333
date	기준 날짜 (형식: YYYY-MM-DD HH:mm)	2024-01-01 00:00

입력한 날짜를 기준으로 -4일 전부터 +15일 후까지의 예보 데이터가 제공됩니다.

[Execute] 버튼을 클릭합니다.

하단의 응답 영역에서 결과를 확인합니다.

문서 링크: Swagger 문서 바로가기

응답 정보

응답 예시

json
복사편집
{
  "code": 200,
  "message": "OK",
  "error": false,
  "timestamp": "2024-12-01T12:00:00",
  "response": [
    {
      "current_u": 10,
      "current_v": 12,
      "dateTime": "2025-05-15T10:05:27.750Z",
      "longitude": 123.456,
      "latitude": 12.345,
      "pressure": 1013.25,
      "windSpeed": 10.5,
      "windDirection": 180,
      "waterTemperature": 25,
      "waveHeight": 2.5,
      "waveDirection": 90,
      "wavePeriod": 5,
      "currentSpeed": 1,
      "currentDirection": 180
    }
  ]
}

JSON
복사

응답 필드 설명

상위 응답 구조

필드명	예시 값	설명
code	200	응답 상태 코드입니다.
message	OK	응답 메시지입니다.
error	false	오류 발생 여부를 나타냅니다.
timestamp	2025-05-15T10:56:59	응답이 생성된 시각(UTC 기준)입니다.
response	배열 또는 null	예보 데이터가 포함된 객체 배열입니다.

예보 데이터 필드 (response 객체)

필드명	예시 값	설명
current_u	10	동서 방향 해류 성분입니다.
current_v	12	남북 방향 해류 성분입니다.
dateTime	2025-05-15T10:05:27.750Z	데이터 기준 시각입니다.
longitude	123.456	대상 위치의 경도입니다.
latitude	12.345	대상 위치의 위도입니다.
pressure	1013.25	해수면 대기압(hPa)입니다.
windSpeed	10.5	풍속(m/s 또는 kt 기준)입니다.
windDirection	180	풍향(도 단위)입니다.
waterTemperature	25	해수 온도(°C)입니다.
waveHeight	2.5	파고(m)입니다.
waveDirection	90	파향(도 단위)입니다.
wavePeriod	5	파도 주기(초)입니다.
currentSpeed	1	조류 속도입니다.
currentDirection	180	조류 방향입니다.

응답 코드 목록

코드	설명
200	요청이 정상적으로 처리되었습니다.
201	리소스가 성공적으로 생성되었습니다.
400	요청 파라미터가 잘못되었습니다.
401	인증이 필요합니다.
403	접근 권한이 없습니다.
422	요청이 처리될 수 없습니다.
429	호출 제한을 초과하였습니다.