跳至主要內容
Administrator Guide
上次更新時間 :2026-04-03
疑難排解︰透過 API 的自訂報告

疑難排解︰透過 API 的自訂報告

API呼叫已逾時。

如果API呼叫在 60 秒內未處理完畢,呼叫將逾時,且您會接收錯誤 ()。
原因
解決方案
資料集的聯結次數過多。
限制資料集中使用的聯結數。
您正在擷取超過 20 個欄位的報告。
將報告中的欄位數限制為 10 到 20 個欄位。如果欄位計數超過 20,請使用 SFTP 擷取報告。
您的資料形狀不規則。範例︰您有大量的巢狀組織。
避免擷取異常龐大的資料集。
您的報告沒有篩選條件
使用適當的篩選條件來控制資料量的增長。範例︰擷取使用定義較小時間範圍的篩選條件(例如
昨天
今天)
修改過的資料。
您已在先前的要求, 申請後 分鐘內提出了一項要求, 申請。對於傳回大量資料或具有多個聯結的報告尤其如此。
避免在短時間內發出多個API要求, 申請。
您正在擷取的報告包含多頁資料。
報告 API 的設計初衷是為了傳回分頁資料集。這是適用於所有 VNDLY HTTP 型 API 的標準限制條件。若要避免此問題,請執行以下操作:
  • 請使用限制 (要傳回的列數) 和抵銷(起始列數) 來擷取單頁資料。
  • 限制報告中包含的欄位數量。
  • 使用 SFTP (而非報告API)來擷取大型報告,而無需分頁。

您從正式環境用戶擷取資料時發生效能問題,而非測試用戶的資料。

效能問題在測試用戶中可能不明顯,因為測試用戶中的資料載入量會少於生產用戶「」。
解決方案︰
  • 請在正式環境上線後驗證報告效能,確認結果與「測試」用戶類似。
  • 為「測試」用戶載入測試資料,且測試資料的大小應可代表正式環境負載。
  • 規劃正式環境中的擴充能力。將正式環境資料報告的預期載入大小與複雜度納入考量。隨著方案成熟或上線後,在門檻附近執行的報告可能會超過門檻。