API服務

1. 為什麼呼叫API傳回400錯誤?

• 為輸入的API參數錯誤或OData語法錯誤，請先於SWAGGER網站進行測試，並確保該資料集欄位有您查詢的篩選條件欄位。

2. 為什麼呼叫API傳回401錯誤?

• 未經授權，APP ID或Key輸入錯誤。

• 如同一時間呼叫多次，API管理員會視同資安攻擊而阻擋您的呼叫，請確保程式每次呼叫一次再接續下一個請求。

• 本平臺採用HMAC加密簽章，由APPKEY與當下時間加密而成，每組簽章具5分鐘時效性，請確保您的程式簽章有隨著時間重新產製簽章。

3. 為什麼呼叫API傳回403錯誤?

• 無該資料集使用權限。

• 或是x-date的間隔時間超過定義的clock skew秒數；x-date日期格式正確，但簽章演算法有問題。

3. 為什麼呼叫API傳回429錯誤?

• 為避免DDoS攻擊阻斷相關服務，API每60秒內限制不可呼叫超過1次，如在60秒內呼叫超過次數，將出現次代碼，請嘗試於60秒後再進行下一次呼叫。

• 為在有限的資源下提供使用者穩定的資料服務水準，因此目前本平臺的正式API服務有限制每日呼叫次數上限為 100 次，當單日呼叫次數超過次數，將出現次代碼。

4. 為什麼呼叫API傳回502錯誤?

• 502表示系統忙碌，可能同一資料表取資料太頻繁，建議您將整張表取回貴單位資料庫再進行運用，或者同一資料表勿同時超過2條連線取資料。

5. 為什麼呼叫出現time out問題?

• 可能為client端因予許等候時間太短而time out，請先嘗試將貴單位client端的time out時間設長一點。

6. 為什麼呼叫API傳回500錯誤?

• 請提供相關的API呼叫參數或錯誤訊息來信客服確認。