設定 Webhook
將 Timemark 指向你的端點，選擇要觸發它的事件與專案，並測試傳送結果。
什麼時候需要這麼做
Section titled “什麼時候需要這麼做”當 Teamspace 發生某些事情時，你希望自己的系統能做出對應反應，例如記錄照片上傳，或觸發後續作業。Webhook 會讓 Timemark 在每次選定的事件發生時，向你的端點傳送一個 POST 請求。
需要準備什麼
Section titled “需要準備什麼”- 角色
- 團隊擁有者
- 平台
- Web
- 方案
- Business
- 影響範圍
- 僅會針對 webhook 建立後發生的事件觸發
設定 Webhook
Section titled “設定 Webhook”- 前往 Teamspace → 設定 → 整合 → Webhook。
- 輸入你的端點 URL。此網址必須可公開存取，並能回應 POST 請求。
- 確認觸發條件。當有新照片上傳時，Webhook 會在 新照片 事件觸發。
- 選擇範圍：所有照片，或特定資料夾。
- 儲存。
- 在你剛儲存的 Webhook 上，使用 測試 或 Ping 功能傳送範例酬載。
- 檢查你端點的日誌，確認酬載是否送達。
- 確認你的端點回傳了
2xx回應。
可設定的欄位
Section titled “可設定的欄位”| Field | What it does | Notes |
|---|---|---|
| 端點 URL | Timemark 傳送 POST 請求的位置 | 必須是公開的，並在逾時前回傳 2xx |
| 觸發條件 | 觸發傳送的動作 | 新照片（photo.uploaded）是目前唯一的觸發條件。請參閱 Webhook 事件類型 |
| 範圍 | 將觸發範圍限制在單一資料夾，或所有團隊照片 | 資料夾範圍僅會針對該資料夾內的照片觸發 |
- 不會回溯觸發。Webhook 只會針對建立之後發生的事件觸發，既有的照片不會觸發它。
- 端點必須即時回傳
2xx。逾時或錯誤會被視為傳送失敗。Timemark 會重試失敗的傳送，重試次數用盡後就會停止。 - 範圍設定不符。若 Webhook 的範圍設為單一資料夾，其他資料夾的照片就不會觸發它。若需要涵蓋所有資料夾，請將範圍設為「所有照片」。
- 位於防火牆之後。位於 VPN 或防火牆後方的端點無法被存取，請提供一個公開的 URL。
最後更新：