投遞與重試
成功的條件
- 10 秒內回應 HTTP
2xx - 回應內容會被忽略（
endpoint.verification除外） 3xx重新導向不會被跟隨，視為失敗；請直接設定最終網址
重試排程
失敗時依序在以下時間後重試：
| 次數 | 間隔 | 累計 |
|---|---|---|
| 第 1 次重試 | 1 分鐘 | 1 分鐘 |
| 第 2 次重試 | 5 分鐘 | 6 分鐘 |
| 第 3 次重試 | 30 分鐘 | 36 分鐘 |
| 第 4 次重試 | 2 小時 | 約 2.6 小時 |
| 第 5 次重試 | 6 小時 | 約 8.6 小時 |
| 第 6 次重試 | 12 小時 | 約 20.6 小時 |
6 次重試都失敗後事件標為「失敗」，內容在建立 24 小時後刪除。需要時可聯絡我們在這段期間內重送。
至少送達一次
同一事件可能送達不只一次（例如你的端點已處理但回應逾時）。請以 webhook-id（或 data.scan_id）去重。
順序
同一端點的事件不保證順序。需要時間順序時，請以 data.scanned_at 排序。
自動停用
端點連續失敗超過 3 天會自動停用，App 與入口網站會顯示狀態。修好後在 App 或入口網站按「驗證」即可恢復。
投遞紀錄
App 與入口網站可查看最近 7 天的投遞紀錄：時間、狀態碼、耗時、錯誤原因。紀錄不含掃描內容。
錯誤原因
| 代碼 | 說明 |
|---|---|
http_error | 端點回應非 2xx |
redirect_not_followed | 端點回應 3xx |
timeout | 10 秒內沒有回應 |
network_error | 無法連線（DNS、TLS、連線被拒） |
url_rejected:private_address | 網址解析到非公開 IP，基於安全不送出 |
endpoint_not_verified | 網址變更後尚未重新驗證 |
速率
每位使用者每分鐘最多上傳 120 次、每日 5,000 筆掃描。需要更高額度請聯絡我們。