📌 네이버 검색 API로 책 정보 검색하기 (Spring Boot 활용)

📅 2025-05-14

📝 학습 내용

---

1️⃣ 검색 API 개요

✅ 네이버 검색 API란?

• 뉴스, 블로그, 백과사전, 책, 웹문서 등 다양한 분야의 검색 결과를 RESTful API로 제공
• XML 또는 JSON 형식으로 결과 반환
• 하루 호출 한도: 25,000회
• 비로그인 방식 오픈 API 클라이언트 ID와 시크릿을 HTTP 헤더에 포함하여 인증 (OAuth 인증 불필요)
  

✅ 애플리케이션 등록

• 네이버 개발자 센터에서 Application 등록
• 사용 API 항목에서 검색 > 책 검색 API 선택

---

2️⃣ Controller 코드 구현 (책 검색)

package com.example.demo.C05Naver;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.*;
import org.springframework.stereotype.Controller;
import org.springframework.util.MultiValueMap;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.RestTemplate;

@Controller
@Slf4j
@RequestMapping("/naver/search")
public class C02NaverSearchController {

    // 🔐 실제 키는 application.yml 또는 환경 변수로 관리해야 안전
    @Value("${naver.client.id}")
    private String NAVER_CLIENT_ID;

    @Value("${naver.client.secret}")
    private String NAVER_CLIENT_SECRET;

    @GetMapping("/book/{keyword}")
    @ResponseBody
    public void book(@PathVariable("keyword") String keyword){
        log.info("GET/naver/search/book...");

        // 1. 요청 URL 설정
        String url = "https://openapi.naver.com/v1/search/book.json?query=" + keyword;

        // 2. 요청 헤더 설정
        HttpHeaders header = new HttpHeaders();
        header.add("X-Naver-Client-Id", NAVER_CLIENT_ID);
        header.add("X-Naver-Client-Secret", NAVER_CLIENT_SECRET);

        // 3. HttpEntity 객체 생성
        HttpEntity entity = new HttpEntity<>(header);

        // 4. RestTemplate으로 GET 요청 전송
        RestTemplate rt = new RestTemplate();
        ResponseEntity<String> response = rt.exchange(url, HttpMethod.GET, entity, String.class);

        // 5. 결과 출력
        System.out.println(response.getBody());
    }
}

---

🔍 테스트 방법

• 브라우저 주소창에서 직접 테스트:

  http://localhost:8090/naver/search/book/오렌지미디어
  

---

🖥️ 콘솔 출력 결과 (요약)

{
  "total": 9,
  "items": [
    {
      "title": "윤성우의 열혈 C 프로그래밍 (개정판)",
      "author": "윤성우",
      "publisher": "오렌지미디어",
      "pubdate": "20101101"
    },
    {
      "title": "윤성우의 열혈 Java 프로그래밍",
      "author": "윤성우",
      "publisher": "오렌지미디어",
      "pubdate": "20170705"
    }
  ]
}

📚 일부 도서 정보 요약 (Markdown 표)

제목	저자	출판사	출간일
윤성우의 열혈 C 프로그래밍	윤성우	오렌지미디어	2010-11-01
윤성우의 열혈 Java 프로그래밍	윤성우	오렌지미디어	2017-07-05
윤성우의 열혈 파이썬 기초편	윤성우	오렌지미디어	2018-11-20

---

🔥 정리

• 네이버 책 검색 API는 클라이언트 ID/시크릿만으로 호출 가능한 RESTful API
• Spring Boot의 RestTemplate으로 헤더를 설정해 간단히 호출 가능
• 응답 데이터를 파싱하면, 웹에 도서 목록이나 상세 정보를 표현할 수 있음

---

🔗 참고 자료

• 네이버 개발자 센터 – 책 검색 API
• Spring RestTemplate 공식 문서

---