MDX運輸資料流通服務API介接範例程式碼說明

為使開發者能快速在M2M環境下介接使用MDX之資料服務API，在此提供數種程式語言的範例程式碼提供開發者做參考。

本專案目前內容僅為範例模板，實際功能與資料內容待後續開發。

API呼叫頻率限制

1. API Endpoint

自113年4月29日中午12:00起，每把API金鑰呼叫次數限制將視會員訂閱的方案而有所不同，各個方案的存取頻率限制說明請參考訂閱收費。

API認證機制

MDX API使用API金鑰進行身份認證，將API金鑰帶入即可存取MDX API服務。詳細步驟說明如下:

1. 註冊為MDX會員

於MDX官網註冊為MDX會員，完成Email驗證、帳號經管理員審核後即可登入MDX網站。

2. 取得API金鑰

登入MDX網站後，於MDX會員中心取得API金鑰，可視開發測試需求自行建立多組API金鑰(目前開放至多3組)。

3. 呼叫MDX API服務

呼叫MDX API時需要將API金鑰帶入請求參數中。curl範例如下:

curl --request GET \
     --url 'MDX_API_URI?APIKey=YOUR_API_KEY'

呼叫API時，可視需求加入Accept-Encoding HTTP Header，可有效減少資料回傳量。呼叫歷史資料類型API時，使用此設定將可大幅降低資料傳輸時間。目前MDX API服務端支援br和gzip兩種模式，Client端可依自身支援的方法來決定Accept-Encoding Header要帶入哪一種模式。使用方式參考如下:

Accept-Encoding: br,gzip

其他說明

傳輸加密通訊協定支援狀況

由於TLS 1.0與TLS 1.1已被證實具有安全風險，為確保網路連線機制的安全性，MDX API與網站僅支援TLS 1.2(含)以上之傳輸加密協定。
TLS與Ciphers支援狀況可參考SSL Labs工具檢測後的結果: