✅ 한국투자증권 오픈API 연동 - 2단계: 요청 URL과 파라미터 구성
📌 1. 개요
오픈API에 요청을 보낼 때는 정확한 요청 URL과 쿼리 파라미터를 구성해야 합니다.
한국투자증권의 REST API는 대부분 GET 방식이며, 쿼리스트링을 통해 종목코드, 날짜, 주기 등 다양한 값을 전달해야 합니다.
📎 2. 사용할 API: 국내주식 일별 시세 조회
- API 설명: 지정한 종목의 일정 기간 동안의 주가(시가/종가/고가/저가/거래량)를 조회합니다.
- HTTP Method: GET
- 요청 URL: https://openapi.koreainvestment.com:9443/uapi/domestic-stock/v1/quotations/inquire-daily-itemchartprice
🧩 3. 주요 쿼리 파라미터
파라미터명설명예시값
| FID_COND_MRKT_DIV_CODE | 시장 구분 코드 (J: 주식) | J |
| FID_INPUT_ISCD | 종목코드 | 005930 (삼성전자) |
| FID_INPUT_DATE_1 | 조회 시작일 (yyyyMMdd) | 20240501 |
| FID_INPUT_DATE_2 | 조회 종료일 (yyyyMMdd) | 20240530 |
| FID_PERIOD_DIV_CODE | 조회 주기 (D: 일별, W: 주간) | D |
| FID_ORG_ADJ_PRC | 수정주가 여부 (0: 미적용) | 0 |
💻 4. 자바 코드로 URL과 파라미터 구성하기
- UriComponentsBuilder를 사용하면 쿼리 파라미터를 안전하게 붙일 수 있습니다.
- 위 코드는 다음과 같은 URL을 생성합니다:
✅ 5. 정리
- 쿼리 파라미터는 API 문서에서 요구하는 필수값을 빠짐없이 넣어야 합니다.
- UriComponentsBuilder를 사용하면 URL 조합 실수를 줄이고 가독성을 높일 수 있습니다.
- 이 URL은 다음 단계에서 헤더와 함께 실제 요청에 사용됩니다.