常見問題

常見問題與解答。

可靠性

1. 資料會丟失嗎?

一旦 API 返回 202 Accepted,系統透過3級自動復原系統保證處理,覆蓋約56小時。請求先加入佇列,即使資料庫故障也不會丟失資料。

2. API 返回 5xx 錯誤怎麼辦?

5xx 錯誤意味著請求未到達我們的系統。您應該在程式碼中實現指數退避重試邏輯。一旦 API 返回 202,我們保證處理。

定價

1. 有免費試用嗎?

有,Free方案每月包含1,000次請求,永不過期。功能與付費方案完全相同。包含沙箱和正式環境。隨時升級以獲得更高額度。

2. 如何變更方案?

您可以在儀表板即時升級。降級也立即生效並按比例發放抵扣額度。每個計費周期最多變更一次。

3. 可以退款嗎?

30天內未使用可全額退款。30天後或產生任何 API 調用後不可退款,但可繼續使用至計費周期結束。

4. Webhook 調用是否計入請求額度?

不計入。即使每次 API 調用觸發多個 Webhook,也只算一次請求。

服務

1. 可以建立多少個端點?

無限制。所有方案均允許建立無限數量的端點。

2. 有每秒速率限制嗎?

沒有每秒限制。僅限制月度總請求數。

3. 修改設定後現有資料會怎樣?

變更僅應用於新請求。現有資料不受影響。

4. Webhook 傳送失敗怎麼辦?

會從佇列重試——正式環境約 5 小時內共 6 次嘗試,沙箱環境約 12 分鐘內共 4 次嘗試(首次投遞算第 1 次)。除 429 外的 4xx 視為永久失敗,不再重試。可在日誌中檢視 Webhook 狀態。

5. 可以透過 API 查詢存儲的資料嗎?

可以,您可以使用記錄 ID 透過 GET 請求查詢單條記錄。儀表板也提供日誌搜尋功能。

6. 協作金鑰和協作者是怎麼工作的?

建立協作金鑰會發放獨立的 API 金鑰,您可以邀請多個協作者到每個金鑰中進行分組管理。您也可以共享預設 API 金鑰,但建立協作金鑰並邀請協作者可以按組分離日誌和統計資料,便於管理。可以建立多個協作金鑰。

7. 我的資料會保留多久?

正式記錄至少保留 60 天,之後按月整批刪除。沙箱用於測試,記錄 30 天後刪除;免費方案的端點本身在建立 7 天後刪除。使用統計單獨保存,不隨記錄刪除,因此儀表板圖表保持完整。若要在保留期之後仍保有資料,請為端點設定 Webhook,或透過 GET /api/v1/data/<your-slug>/poll 輪詢,讓記錄抵達時就進入您自己的系統。

8. 什麼是正式控制台?

正式控制台是僅限所有者使用的功能,可從儀表板直接管理正式資料(建立、讀取、更新、刪除),無需透過外部 API 調用。在端點詳情頁的正式標籤頁中訪問。

資料

1. 取消訂閱後資料會怎樣?

取消後,您的帳戶將在計費周期結束時切換為Free方案。此後將無例外地適用Free方案資料政策:建立超過 7 天的端點會在下一個清理週期被刪除,其沙箱與正式資料一併刪除。請在取消前下載需要保留的資料。