通知概覽#
Apidog 可讓你與第三方應用程式整合,以便在特定事件發生時向指定接收者傳送通知。當特定事件被觸發時,通知會即時傳送到 Slack 等平台。目前支援的通知渠道包括:只有 專案管理員 可以設定通知。目前,電子郵件通知僅適用於以下事件:通知目標#
通知目標是指在特定事件發生時,透過特定渠道接收訊息的接收者。若要設定通知,首先需要透過指定名稱、選擇渠道並設定其選項來建立通知目標。每個渠道都有獨特的設定流程。以下章節將逐步引導你完成設定。Slack#
Apidog 支援透過整合 Slack apps - Incoming WebHooks,將通知事件傳送到 Slack 中指定的 Channel。在指定 Channel 中設定 Incoming WebHooks 的 Webhook URL 後,即可將事件訊息傳送到 Slack Channel。| 設定欄位 | 必填 | 說明 |
|---|
| 通知名稱 | 否 | 為第三方整合通知命名,以記錄其用途。 |
| 觸發事件 | 是 | 支援的事件:API 變更、schema 變更、文件變更、匯入資料、自動化測試 |
| 服務 URL | 是 | 「Incoming WebHooks - Integration Settings」中的 Webhook URL |
將 Apidog 通知與 Slack 整合#
專案管理員可以使用第三方整合功能,將 Slack 中新增至 Channels 的 Slack apps - Incoming WebHooks 與 Apidog 中的專案通知事件關聯,以將相關 API 變更、文件變更、測試完成等推送到 Slack 中指定的 Channel。步驟 1:開啟頻道詳細資訊
在 Slack 頻道中,點選右上角的「Open channel details」選項。步驟 2:安裝 Incoming WebHook
在特定 Channel 的 Integrations - Apps 中,安裝並新增 Incoming WebHook。步驟 3:檢視 Incoming WebHooks
安裝完成後,點選 Incoming WebHooks 右側的 View 按鈕。步驟 4:設定 Incoming WebHooks
這會開啟 Incoming WebHooks 的說明頁面,點選 Configuration 進行設定。步驟 5:新增到 Slack
步驟 6:選擇 Channel 並新增整合
選擇要推送 Apidog 通知事件訊息的 Channel,然後點選 Add Incoming WebHooks integration。步驟 7:取得 Webhook URL
步驟 8:在 Apidog 中建立通知目標
點選「Settings」>「Notifications」>「Notification Targets」>,並建立新的通知 Target。將從 Incoming WebHooks 設定中取得的 Webhook URL 貼到 Service URL。
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。通知事件設 定並觸發後,你將在指定的 Slack 頻道中收到訊息。Teams#
支援將通知傳送到 Microsoft Teams,讓 Teams 中的 Workflows 可使用這些訊息作為觸發條件,以執行後續動作——例如自動在群組或頻道中發布訊息——協助團隊掌握來自 Apidog 的重要事件。具體來說,你可以在 Workflow 中設定 Webhook Trigger。當 Apidog 中的特定通知事件被觸發時(例如 API 變更、文件更新或自動化測試完成),Apidog 會向該觸發器指定的 HTTP POST URL 傳送 POST 請求,並攜帶事件 payload。| 欄位 | 必填 | 說明 |
|---|
| 名稱 | 是 | 說明此通知目標用途的名稱 |
| HTTP POST URL | 是 | Workflow 中的 Webhook Trigger 接收 POST 請求的 URL |
將 Apidog 通知與 Teams 頻道整合#
步驟 1:在 Teams 中建立 workflow
在 Microsoft Teams → Workflow 中,點選 Create,並可透過選擇範本 Post to a channel when a webhook request is received 快速開始。步驟 2:設定流程名稱與帳戶
為流程設定名稱,選擇適當的帳戶,然後點選 Next。步驟 3:選擇群組與頻道
選擇要接收通知的群組與頻道,然後點選 Create flow。步驟 4:取得 HTTP POST URL
流程建立後,觸發步驟下方會顯示 HTTP POST URL。你可以直接複製,或稍後在流程的觸發步驟中找到它。步驟 5:在 Apidog 中設定通知目標
將此 HTTP POST URL 貼到 Apidog 的通知目標設定中。步驟 6:建立通知事件
在 Apidog 中建立通知事件,並將其與已設定的 Teams 通知目標關聯。步驟 7:驗證 Teams 通知
當此通知事件被觸發時,先前建立的 workflow 會自動將訊息發布到所選的 Teams 頻道。Webhook#
支援將通知事件傳送到 HTTP Server。你可以指定用於接收 POST 請求的 URL 位址,將事件訊息傳送到 HTTP Server。| 設定欄位 | 必填 | 說明 |
|---|
| 通知名稱 | 否 | 為第三方整合通知命名,以記錄通知用途。 |
| 觸發事件 | 是 | 支援的事件:API 變更、資料模型變更、文件變更、匯入資料、自動化測試 |
| 伺服器 URL | 是 | 用於接收請求的 HTTP Server URL 位址 |
| 簽章驗證 | 否 | 傳送的內容會透過 HMAC SHA1 加密演算法加密,使用 token 作為 KEY,以十六進位顯示值(需要已設定 token),並包含前綴 sha1= |
將 Apidog 通知與自架 HTTP Server 整合#
專案管理員可以使用第三方整合,將自架 HTTP Server 與 Apidog 中的專案通知事件關聯,以在其 HTTP Server 中接收相關 API 變更、文件變更與自動化測試完成的通知。若要將 Apidog 通知與自架 HTTP server 整合,請點選「Settings」>「Notifications」>「Notification Targets」>,並建立新的通知 Target。3.
在 Service URL 欄位中貼上自架 HTTP Server 的 URL。
4.
如果已啟用簽章驗證,請將金鑰複製並貼到 Signature Key 欄位。
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。Jenkins#
支援將通知事件傳送到 Jenkins 服務。透過設定 Jenkins Webhook URL,可將事件訊息傳送到 Jenkins。將 Apidog 通知與 Jenkins 服務整合#
專案管理員可以使用第三方整合功能,將 Jenkins Generic Webhook Trigger 外掛程式中設定的 Webhook URL 與 Apidog 中的專案通知事件關聯,以便在 API 變更、文件變更和自動化測試完成等事件被觸發時,自動在 Jenkins 中觸發建置動作,並在建置歷史中檢視訊息。步驟 1:在 Jenkins Generic Webhook Trigger 外掛程式中設定 Webhook URL
在 Jenkins Dashboard 上建立新的檢視:點選上一步中的檢視以進入 Configure>Build Triggers,並選擇 Generic Webhook Trigger。Webhook URL 為 "http://"+"your service address"+"/generic-webhook-trigger/invoke"步驟 2:建立新的通知目標
點選「Settings」>「Notifications」>「Notification Targets」>,並建立新的通知 Target。如果使用自訂 token,請將 Token 複製並貼到 Signature Token 欄位。
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。通知事件設定並觸發後,Jenkins 會自動啟動建置動作,你可以在建置歷史中檢視訊息:Email#
通知可以透過電子郵件傳送到指定的電子郵件地址。目前,電子郵件通知僅適用於以下事件:| 欄位 | 必填 | 詳細資訊 |
|---|
| 名稱 | 是 | 描述性名稱,用於突顯通知目標的用途或特性。 |
| 通知電子郵件地址 | 是 | 輸入要接收通知的電子郵件地址。你可以選擇專案成員的電子郵件地址,或手動輸入地址。支援多個電子郵件地址。 |
將 Apidog 通 知與 Email 整合#
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。通知事件#
你可以建立通知事件,以指定哪些事件會觸發通知並傳送給指定接收者(通知目標)。若要設定通知事件,需要設定:觸發事件#
| 觸發事件 | 詳細資訊 |
|---|
| 端點已變更 | 端點已建立 端點已更新 端點已刪除 |
| Schema 已變更 | Schema 已建立 Schema 已更新 Schema 已刪除 |
| 文 件已變更 | 文件已建立 文件已更新 文件已刪除 |
| 資料匯入 | 匯入(手動匯入) 匯入(自動同步) |
| 回應元件已變更 | 回應元件已建立 回應元件已更新 回應元件已刪除 |
| Sprint 分支已變更 | Sprint 分支已合併 Sprint 分支已建立 Sprint 分支已封存 Sprint 分支已刪除 Sprint 分支已取回 |
| API 版本已變更 | API 版本已建立 API 版本已刪除 |
| 安全性方案已變更 | 安全性方案已建立 安全性方案已更新 安全性方案已刪除 |
對於與自動化測試相關的通知(例如自動化測試完成、持續整合完成、排程任務完成),你需要針對每個測試情境個別設定。此方式更具彈性,也更符合實際使用案例。
通知目標#
選擇當觸發事件發生時,哪些通知目標會接收通知。你可以從專案中已設定的通知目標中選擇,並可視需要選取多個目標。