앱 만들기

 

대시보드 > 어플리케이션 에서 하단에 있는 ‘응용 프로그램 추가’ 버튼을 통해 앱을 생성 합니다.

 

  • 응용 프로그램 이름

  • 플랫폼

  • 설명

 

‘Application 정보’에 해당 항목을 입력하고, ‘Next Step’ 버튼을 클릭 합니다.  

 

  • API 선택

  • 이용약관 동의

 

‘API관리’ 탭에서는 사용할 API를 선택하고, 그에 해당하는 API ‘이용 약관에 동의’를 하고, 더이상 사용할 API가 없으면 ‘Next Step’버튼을 누릅니다.

 

  • Callback URL

  • Scope

  • 유형

 

‘인증’ 의 Callback URL, Scope, 유형 항목은 사용할 API의 인증 방식이  OAuth (현재는 OAuth2.0만 지원)일때는 필수로 입력해야 합니다.

유형은 ‘public’ 를 선택 합니다. (현재는 OAuth2.0 Grant Type 중 Authorization Code 방식만 지원함)

 

% ‘API문서 > 서비스’의  Swagger UI로 OAuth2.0을 테스트 하시려면, Callback URL을 ‘https://developers.koscom.co.kr/resources/oauthCallback.html’ 와 같이 입력 하세요. %

 

‘저장’ 버튼을 누르고 정상적으로 접수가 되면 앱이 추가 되고, 앱 상태가 ‘승인 보류’가 됩니다.

코스콤 개발자센터 관리자가 해당 앱의 사용을 승인 하면 회원정보에 등록된 이메일로 ‘앱 승인’

메일을 받으 실 수 있습니다.

% 앱 등록 정책에 맞지 않으면 해당 사유와 함께 거부 될 수도 있습니다. %

 

API  테스트 하기

‘APIs & 플랜’ 메뉴에서 테스트 하려는 API의 인증 유형을 확인 합니다.

 

API Key 타입

 

‘API문서 > 시세 서비스 > 주식 종목’ 메뉴에서 ‘Select an Application’  을 눌러서 앱을 선택 합니다.

%  앱이 보이지 않으시면 해당 API를 사용하는 앱을 먼저 만드셔야 합니다. %

‘Authentucation (None)’ 버튼을 누르시고, 인증 방식을 ‘API Key’로 선택 합니다.

 


 

해당 API의 Method가 ‘GET’ 방식이면, ‘API Key Type’를 Query로 선택 하시고, ‘POST’ 방식이면

Header 방식으로 선택 하세요.

 

테스트할 API를 선택 하시고, ‘Try it Out’ 버튼을 누르시면 아래와 같이 Response 결과를 받아 보실 수 있습니다.

% 기타 에러 코드는 별도 참조 %

 

‘Query’ 버튼을 누르시면 Request 및 다양한 랭귀지의 샘플 데이터를 참고 하실 수 있습니다.

 

OAuth2.0 타입

% 현재는 OAuth2.0 Grant Type 중 Authorization Code만 지원 %

 

‘APIs & 플랜’ 메뉴에서 ‘OAuth2.0-Authorization Code를 지원하는 API를 확인 합니다.

테스트할 앱을 선택하고, ‘OAuth2.0’을 선택 합니다.

 

  • Grant Type

Authorization Code’를 선택 합니다.

  • Client ID

앱의 API Key 값을 입력 합니다. (자동 입력)

  • Client Secret

앱의 Secret 값을 입력 합니다. (자동 입력)

  • Scope

앱에 등록한 Scope 값을 입력 합니다

  • Authorize Endpoint

https://sandbox-apigw.koscom.co.kr/auth/oauth/v2/authorize’ 값을 입력 합니다.

  • Token Endpoint

https://sandbox-apigw.koscom.co.kr/auth/oauth/v2/token’ 값을 입력 합니다.

 


 

‘OK’ 버튼을 누르시면, 사용자 로그인창이 오픈 됩니다.

 

% 테스트용 아이디 및 비밀번호는 PDF 참조 %

가상 증권사 (다이아몬드/사이버/스타증권) 계좌서비스 테스트용 목업데이터 (PDF)

 

아이디 및 비밀번호를 입력하시고, 로그인 합니다.

 

테스트할 API를 선택 하시고, ‘Try it Out’ 버튼을 누르시면 아래와 같이 Response 결과를 받아 보실 수 있습니다.

 

 

‘Query’ 버튼을 누르시면 Request 및 다양한 랭귀지의 샘플 데이터를 참고 하실 수 있습니다.