📌 SpringBoot + 기상청 초단기실황 API 연동 (RestTemplate + Thymeleaf)

My Pale Blue Dot·2025년 5월 9일

API Spring Springboot openapi 기상청

SPRING BOOT

목록 보기

12/40

📅 2025-05-09

📝 학습 내용

RESTful API 개념 정리
공공데이터포털 API 신청 및 인증키 사용
기상청 초단기실황 API 호출
JSON 응답 구조 확인 → Java DTO 클래스 자동 생성
데이터 출력: Thymeleaf 뷰 연동

✅ 1. RESTful API란?

REST: 자원을 URI로 표현하고, HTTP 메서드로 조작하는 아키텍처 스타일
RESTful API는 REST 원칙을 지킨 API
- GET: 조회
- POST: 생성
- PUT: 수정
- DELETE: 삭제

✅ 2. 공공데이터포털에서 API 신청 및 인증키 확인

공공데이터포털에서 “기상청 초단기실황” 검색 후 신청
발급된 serviceKey는 반드시 디코딩된 형태로 사용

예시 디코딩 키:
xYZ80mMcU8S57mCCY/q8sRsk7o7G8NtnfnK7mVEuVxdtozrl0skuhvNf34epviHrru/jiRQ41FokE9H4lK0Hhg==

❗ 디코딩하지 않으면 아래 오류 발생:

<returnAuthMsg>SERVICE_KEY_IS_NOT_REGISTERED_ERROR</returnAuthMsg>

✅ 3. Gradle 의존성 추가

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    implementation 'com.fasterxml.jackson.core:jackson-annotations:2.19.0'
}

✅ 4. JSON 응답 구조 확인 및 Java 클래스 자동 생성

🔎 Step 1: 콘솔에서 JSON 응답 확인

{
  "response": {
    "header": { "resultCode": "00", "resultMsg": "NORMAL_SERVICE" },
    "body": {
      "dataType": "JSON",
      "items": {
        "item": [
          {
            "baseDate": "20250509",
            "baseTime": "1600",
            "category": "PTY",
            "nx": 89,
            "ny": 90,
            "obsrValue": "0"
          }
        ]
      },
      "pageNo": 1,
      "numOfRows": 10,
      "totalCount": 8
    }
  }
}

🔄 Step 2: JSON → Java 자동 변환

JSON TO JAVA사용

결과로 아래와 같은 클래스가 자동 생성됨 👇

@Data
private static class Item {
    public String baseDate;
    public String baseTime;
    public String category;
    public int nx;
    public int ny;
    public String obsrValue;
}
@Data private static class Items { public ArrayList<Item> item; }
@Data private static class Body { public String dataType; public Items items; public int pageNo; public int numOfRows; public int totalCount; }
@Data private static class Header { public String resultCode; public String resultMsg; }
@Data private static class Response { public Header header; public Body body; }
@Data private static class Root { public Response response; }

📌 이 과정을 통해 RestTemplate으로 받은 JSON을 자동으로 Java 객체로 바인딩할 수 있음.

✅ 5. API 호출 및 JSON 파싱

String fullUrl = ...; // 위에서 만든 URL

RestTemplate rt = new RestTemplate();
ResponseEntity<Root> response = rt.exchange(fullUrl, HttpMethod.GET, null, Root.class);

✅ 6. 데이터 추출

Root root = response.getBody();
Response rs = root.getResponse();
Body body = rs.getBody();
Items items = body.getItems();
List<Item> list = items.getItem();

list.forEach(item -> log.info(item.toString()));

✅ 7. Thymeleaf로 뷰에서 출력

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>대구 날씨</title>
</head>
<body>
<h1>🌤 대구 중구 날씨 실시간 조회</h1>
<hr/>
<th:block th:each="item : ${list}">
    <div>날짜: <span th:text="${item.baseDate}"></span></div>
    <div>시간: <span th:text="${item.baseTime}"></span></div>
    <div>항목: <span th:text="${item.category}"></span></div>
    <div>X좌표: <span th:text="${item.nx}"></span></div>
    <div>Y좌표: <span th:text="${item.ny}"></span></div>
    <div>관측값: <span th:text="${item.obsrValue}"></span></div>
    <br/>
</th:block>
</body>
</html>

✅ 8. 최종 Controller 전체 코드

@Controller
@Slf4j
@RequestMapping("/openData")
public class OpenData02Controller {

    String url = "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtNcst";
    String serviceKey = "디코딩된_키_입력";

    @GetMapping("/forcast")
    public void forcast(Model model) {
        String fullUrl = url
            + "?serviceKey=" + serviceKey
            + "&pageNo=1"
            + "&numOfRows=10"
            + "&&base_date=20250509"
            + "&base_time=1600"
            + "&dataType=JSON"
            + "&nx=89"
            + "&ny=90";

        RestTemplate rt = new RestTemplate();
        ResponseEntity<Root> response = rt.exchange(fullUrl, HttpMethod.GET, null, Root.class);

        List<Item> list = response.getBody().getResponse().getBody().getItems().getItem();
        model.addAttribute("list", list);
    }

    // DTO 클래스 생략: 위 정의 참고
}

🔥 정리 요약

항목	설명
🔑 인증키	반드시 디코딩된 형태 사용
✅ JSON 구조	콘솔 확인 후 jsonschema2pojo로 변환
🔁 RestTemplate	exchange + DTO 매핑으로 처리
🧩 Thymeleaf	리스트 데이터를 `th:each`로 출력