安裝群益API

1.安裝之前的準備事項

注意!群益在2022-5-1以後已經不支援Windows7平台，如要使用群益API會建議在Windows10以後的作業系統安裝(如果你仍要使用Windows7作業系統請參考"群益API無法在Windows7使用問題")

請確認您是群益的證券/期貨用戶，如未開戶請攜帶身分證等證件和印章到附近群益券商分點開戶，新開戶請在開戶當下同時申請開通下單API權限(建議一併要求增加連線數與訂閱商品數量，群益API後期只提供兩個連線數(這樣你頂多只能同時跑兩個策略)，商品報價限制在100檔)。

如果您已經是群益的證券/期貨用戶，可以參考這篇申請API(手機申請)文章， 或直接線上簽署同意書，點選群益同意書簽署(需要事先登入，如重新登入請選擇右上方選單的服務>同意書簽署)網頁內容畫面很長，可簽署的項目很多，要稍微捲動一下才會找到想簽的項目，請至少簽署[證券API服務下單聲明書] 和 [期貨API下單聲明書]。

先捲動畫面到中間，可以看到[證券API服務下單聲明書]項目，點選輸入帳號密碼後，看完聲明書選擇同意

群益同意書簽署畫面

之後在簽署畫面捲到下面可以看到[期貨API服務下單同意書]項目，點選輸入帳號密碼後，看完聲明書選擇同意
期貨API服務下單同意書

另外，如果需要下單需要申請電子憑證並安裝，通常在開戶過程會以EMail告知程序，同時也請安裝任一套群益提供的電子下單軟體，例如群益贏家策略王，以測試憑證安裝是否正確和方便到時候用GSnail下單時，可以交互比對或人工處理下單問題。

2.下載API元件

點選下載群益API看到下面畫面 選擇點此登入下載

下載群益API

之後會看到登入畫面，輸入身分證字號，密碼，驗證碼後，按確定，接下來在畫面中間點選API元件的立即下載

API元件下載

下載後會取得一個壓縮檔 例如 [CapitalAPI_2.13.25.zip](實際名稱會依當時網站提供的版號而定)請將此檔移動到你自建的券商API目錄(例如D:\APIs)將此壓縮檔解開會產生一個新的子目錄 [CapitalAPI 2.13.25] 。

3.安裝元件&下單憑證

點開解壓縮後的目錄(例如 CapitalAPI_2.13.25)可以看到一個[元件]的子目錄，請點進[元件]目錄，接下來會看到[x64]跟[x86]兩個目錄，"GSnail目前僅提供32位元版，即使你的作業系統是64位元也請務必選擇[x86]子目錄安裝"，打開之後你會看到以下畫面

安裝元件

請把滑鼠游標移到install.bat檔案，按滑鼠右鍵打開選單，選擇以系統管理員身分執行，如果成功安裝，恭喜你你會看到以下提示訊息。

RegSvr32安裝成功

2021-10-19 新增 

注意!群益新版報價API  2.13.35版以後，改雙因子登入認證，您如果有使用群益API看報價的電腦(即使只看報價不下單)，請務必安裝有效的群益下單憑證，否則會無法登入API收不到報價

4.測試是否正常

安裝完成後可以在同目錄底下執行 SKCOMTester.exe 測試申請的下單API是否正常安裝與開通權限，打開程式後

API測試程式

請按下述步驟操作

1.輸入您的身分證號和密碼

2.按登入按鈕(LogIn1) 如果成功會在訊息方塊中看到 "登入成功"訊息(08:12:52.0811588 登入成功)

3.接下來在下方頁籤切換到[報價]頁面

4.點選[Connect]按鈕，等待數秒後旁邊的 solace_QuoteServer 圓形燈號會變成綠色，上方訊息方塊會看到 [Quote][SKQuoteLib_EnterMonitor][SK_SUCCESS]訊息

5.在報價頁面中，下方區域有很多可以選，在第一個頁籤[Quote]中按[查詢]按鈕 會看到三個商品的報價畫面(TX00,MTX00,6005)

5.問題排解

  1. 如果您在安裝元件時，出現"無法載入模組 [安裝目錄]\元件\x86\SKCOMM.dll" (英文The module "SKCOM.dll" failed to load.) ...等，可能您的電腦缺少安裝微軟的某些必要DLL，請參考以下連結安裝
    Microsoft Visual C++ 2010 Service Pack 1 MFC 可轉散發套件的安全性更新
     
  2. 如果在安裝install.bat 時電腦沒有出現"DllRegisterServer在 [安裝目錄]\元件\x86\SKCOMM.dll 成功"的提示畫面，請以系統管理員身分手動執行CMD.exe，在命令列畫面中輸入 regsvr32  [安裝目錄]\元件\x86\SKCOMM.dll  按Enter執行看是否會出現"DllRegisterServer在 [安裝目錄]\元件\x86\SKCOMM.dll 成功"畫面
     
  3. 如果看到的錯誤訊息包含"元件擷取(CLSID 為{AC30BAB5-194A-4515-A8D3-6260749F8577}) 的 COM Class Factory 失敗: 80040154 類別未登入"，請確認您安裝的是[X86]目錄下單API元件，因為一般人會直覺認為作業系統是64位元，所以直接安裝[X64]下的API元件|
     
  4. 注意!群益API 於V2.13.35 實施雙因子登入，並採用下單憑證綁方式，如果電腦安裝2.13.35以後版本的群益API 請確認您的電腦有安裝群益的下單憑證且狀態未過期