로그인과 버전관리

로그인 개요

키움OpenAPI에서 로그인기능은 CommConnect()함수를 호출하면 된다. 그러면 로그인창이 열리고 운영서버(실제서버)와 모의투자 접속을 선택할 수있다. 그리고 자동로그인 설정을 통해서 자동로그인을 사용할 수 있다. 하지만 자동로그인은 버전업 처리가 되지 않는다.

 

수동 로그인

 

수동 로그인은 로그인창에 사용자가 직접 아이디와 비밀번호를 입력하는 방식입니다. 로그인시 버전처리내용이 있는 경우 버전처리도 함께 진행됩니다.

 

자동 로그인

 

 

로그인한 다음 계좌비밀번호 입력창을 통해 자동로그인을 설정할 수 있습니다. 트레이 메뉴(모니터 오른쪽 하단)에서 키움openAPI트레이 아이콘을 오른쪽 클릭하고 "계좌비밀번호 저장" 메뉴를 선택하면 계좌비밀번호 입력화면이 표시됩니다. 여기서 로그인 이후 사용할 계좌와 계좌비밀번호를 입력하고 등록버튼을 눌러서 저장한 다음 계좌번호 아래에 있는 AUTO체크 박스를 선택하시면 자동 로그인이 됩니다. 자동로그인시 비전처리가 안됩니다. 그래서 버전처리를 받으려면 AUTO버튼을 체크해지하고 프로그램을 재 실행 하시면 됩니다.

 

버전 처리

로그인중에는 버전처리가 함께 처리될 수 있는데 이때 "버전처리를 받으시려면 현재 실행 중인 OpenAPI OCX를 탑재한 프로그램을 종료하신 후 확인버튼을 눌러주시기 바랍니다. 그대로 진행시 버전처리가 정상적으로 실행되지 않습니다."안내 메시지창을 출력됩니다. 이 메시지창에 소개된 대로 KOA Studio를 포함해서 실행중인 모든 OpenAPI프로그램을 먼저 종료해주시고 버전처리를 진행하셔야 합니다. 그렇지 않으면 버전처리가 안되며 버전처리가 완료될때까지 같은 메시지 창이 출력됩니다.

 

모의투자

로그인 창에서 모의투자접속을 선택을 체크하면 모의투자로 접속하며 체크를 풀면 운영서버로 접속합니다. KOA Studio 프로그램은 모의투자로만 접속가능해서 모의투자접속 체크 해지가 않됩니다. 모의투자 사용은 키움증권 홈페이지에서 신청할 수 있습니다.  상세한 내용은 홈페이지 내용을 참고해 주세요.

 

기타

한 PC에 같은 ID로 중복해서 운영서버에 로그인하면 마지막에 로그인한 경우만 유지되고 이전에 로그인은 자동으로 로그오프됩니다. 그러나 다른 PC를 이용해서 중복 로그인 하거나 같은 PC에 모의투자로 로그인하게 되면 모두 로그인 상태를 유지하게 됩니다.

 

로그인 관련 함수

long CommConnect()

수동 로그인설정인 경우 로그인창을 출력해서 로그인을 시도하거나 자동로그인 설정인 경우 로그인창 출력없이 로그인을 시도합니다. 로그인이 성공하거나 실패하는 경우 OnEventConnect 이벤트가 발생하고 이벤트의 인자 값으로 로그인 성공 여부를 알 수 있다.  리턴값 0: CommConnect()호출 성공, 음수값: CommConnect()호출 실패

 

void CommTerminate()

로그아웃용 함수였는데, 이제 더이상 지원하지 않는다. 로그아웃을 하려면 프로그램을 종료하고 다시 로그인해야 한다.

 

long GetConnectState()

현재 로그인 상태를 알려줍니다. 리턴값 1: 연결, 0: 연결안됨

 

string GetLoginInfo(string sTag)

로그인 후 사용할 수 있으며 인자값(string)에 대응하는 정보를 얻을 수 있습니다. 인자는 다음값을 사용할 수 있습니다.

• "ACCOUNT_CNT" : 보유계좌 수를 반환합니다.
• "ACCLIST" 또는 "ACCNO" : 구분자 ';'로 연결된 보유계좌 목록을 반환합니다.
• "USER_ID" : 사용자 ID를 반환합니다.
• "USER_NAME" : 사용자 이름을 반환합니다.
• "KEY_BSECGB" : 키보드 보안 해지여부를 반환합니다.(0 : 정상, 1 : 해지)
• "FIREW_SECGB" : 방화벽 설정여부를 반환합니다.(0 : 미설정, 1 : 설정, 2 : 해지)
• "GetServerGubun" : 접속서버 구분을 반환합니다.(1 : 모의투자, 나머지 : 실서버)

"strAcctList"는 ';'로 분리한 보유계좌 목록을 string으로 리턴한다. 예) "3040525910;567890;3040526010"

 

void OnEventConnect(long nErrCode)

로그인 처리 이벤트 함수입니다. 성공이면 인자값 nErrCode가 0이며 에러는 다음과 같은 값이 전달됩니다.

• 0 : 로그인 성공
• -100 : 사용자 정보교환 실패
• -101 : 서버접속 실패
• -102 : 버전처리 실패

로그인 처리 과정