한국투자증권 OpenAPI RestAPI Postman 사용 방법 2

한국투자증권에서 제공하는 OpenAPI 중에서 RestAPI 사용법입니다. 

OAuth 값을 얻어오는 방법입니다.

 

1. API 문서와 Postman 확인

API 사이드를 보면 아래와 같이 메뉴를 제공합니다.

 

그리고 GIT에서 postman json 파일을 받아보면 아래와 같이 메뉴가 있습니다.

 

사용 방법은 동일합니다.

 

2.실시간 (웹소켓) 접속키 발급

https://apiportal.koreainvestment.com/apiservice/oauth2#L_5c87ba63-740a-4166-93ac-803510bb9c02

 

주식정보는 조회시점의 정보를 받는 것과 실시간 정보를 계속적으로 받는 것이 있습니다.

조회시점에 정보를 받는 key 값과는 다르게,

실시간 시세 정보를 받기 위해서는 실시간 전용 key를 받아야 합니다.

기능 구현을 위해서도 실시간 정보는 웹소켓 기능을 구현해야 합니다.

 

접속키의 유효기간은 24시간이지만, 접속키는 세션 연결 시 초기 1회만 사용하기 때문에,

접속키 인증 후에는 세션종료되지 않는 이상 접속키 신규 발급받지 않으셔도 365일 내내 데이터 수신이 가능합니다.

 

Postman에서 이미 PROD_APPKEY 값과, PROD_APPSECRET 값을 넣어놓았으니

send버튼만 누르면  approval_key 값을 얻을 수 있습니다.

 

3.Hashkey

정보를 암호화 하여 받기 위해서 hashkey를 생성합니다.

저는 사용해 본적이 없습니다만 필요한 경우가 있겠죠?

CANO 값을 입력해야 하는데, 개인 주식 계좌번호입니다.

공개되지 않도록 조심하세요

 

미리 입력되어 있어야 하는 값은 PROD_APPKEY 값, PROD_APPSECRET 값, CANO 값 입니다.

 

4. 접근토큰 발급

조회 시점의 데이터를 받아오기 위한 접근토큰 발급입니다.

계좌 조회도 해당 토큰을 사용합니다.

 

잦은 토큰 요청으로 정책 변경이 있어, 접근토큰(access_token)의 유효기간은 24시간 이며(1일 1회발급 원칙)
갱신발급주기는 6시간 입니다.(6시간 이내는 기존 발급키로 응답)

접근 토큰 유효기간을 유의하여 관리를 할 필요가 있습니다.

 

5. 접근토큰 폐기

접큰토큰을 더 이상 활용하지 않을 때 사용합니다.

 

토큰 발급은 어렵지 않습니다.