Apidog Docs
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
  1. 管理專案
  • Apidog 學習中心
  • 開始使用
    • Apidog 簡介
    • Apidog 中的基本概念
    • 導覽 Apidog
    • 快速開始
      • 概覽
      • 建立端點
      • 發送請求
      • 新增斷言
      • 建立測試情境
      • 分享 API 文件
      • 探索更多
    • 遷移到 Apidog
      • 概覽
      • 手動匯入
      • 排程匯入(綁定資料來源)
      • 匯入選項
      • 匯出資料
      • 匯入自
        • 從 Postman 匯入
        • 匯入 OpenAPI 規格
        • 匯入 cURL
        • 匯入 Markdown
        • 從 Insomnia 匯入
        • 從 apiDoc 匯入
        • 匯入 .har 檔案
        • 匯入 WSDL
  • Mock API 資料
    • 概述
    • Smart Mock
    • 自訂模擬
    • 模擬優先順序
    • 模擬腳本
    • 雲端模擬
    • 自託管 Runner 模擬
    • 模擬語言(Locales)
  • 帳號與偏好設定
    • 帳戶設定
    • 產生 OpenAPI 存取權杖
    • 通知
    • 語言設定
    • 快捷鍵
    • 網路代理設定
    • 備份資料
    • 更新 Apidog
    • 刪除帳戶
    • 實驗性功能
  • 傳送請求
    • 概覽
    • SSE 偵錯
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 或 WebService
    • GraphQL
    • gRPC
    • 使用請求代理代理程式進行偵錯
    • 建立請求
      • 請求歷史記錄
      • 請求基礎
      • 參數與主體
      • 請求標頭
      • 請求設定
      • 偵錯請求
      • 將請求儲存為端點
      • HTTP/2
    • 驗證與授權
      • 概覽
      • CA 和用戶端憑證
      • 授權類型
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 驗證
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 回應和 Cookie
      • 檢視 API 回應
      • 管理 Cookie
      • 概覽
  • 開發和偵錯 API
    • 概觀
    • 產生請求
    • 傳送請求
    • 偵錯案例
    • 測試案例
    • 動態值
    • 驗證回應
    • Design-First 與 Request-First
    • 產生程式碼
    • 環境與變數
      • 概述
      • 使用變數
      • 環境管理
    • Vault 密鑰
      • 概覽
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 動態值模組
      • Airline
      • 動物
      • 顏色
      • Commerce
      • Company
      • 資料庫
      • Datatype
      • 日期
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • 圖片
      • Internet
      • 位置
      • Lorem
      • 音樂
      • Number
      • Person
      • Phone
      • 科學
      • 字串
      • System
      • Vehicle
      • Word
    • 前置和後置處理器
      • 概覽
      • 斷言
      • 擷取變數
      • Wait
      • 安全性
      • 資料庫操作
        • 概述
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 使用腳本
        • 概觀
        • 前置處理器指令碼
        • 後置處理器腳本
        • 公開腳本
        • Postman Scripts Reference
        • 呼叫其他程式語言
        • 使用 JS Libraries
        • 視覺化回應
        • 腳本範例
          • 斷言腳本
          • 使用變數
          • 修改請求
          • 其他範例
    • API 偵錯
      • AI Agent Debugger
      • A2A Debugger
  • 設計 API
    • 概覽
    • 建立新的 API 專案
    • 端點基礎
    • APl 設計指南
    • 模組
    • 設定多個請求主體範例
    • 元件
    • 通用欄位
    • 全域參數
    • 端點變更歷史
    • 留言
    • 批次端點管理
    • 自訂協定 API
    • Spec-first 模式 (Beta)
    • 安全方案
      • 概觀
      • 建立安全性方案
      • 使用 Security Scheme
      • 線上文件中的安全性方案
    • 進階功能
      • 自訂端點欄位
      • 關聯的測試場景
      • 端點狀態
      • 參數列表的外觀
      • 端點唯一識別
    • Schemas
      • 概述
      • 建立新 Schema
      • 建立 Schema
      • 從 JSON 等產生 Schema
      • oneOf, allOf, anyOf
      • 使用 Discriminator
  • API 測試
    • 概述
    • 測試情境
      • 建立測試情境
      • 在請求之間傳遞資料
      • 流程控制條件
      • 從端點和端點案例同步資料
      • 從其他專案匯入端點和端點案例
      • 匯出測試情境
    • 測試報告
      • 測試報告
    • 執行測試情境
      • 執行測試場景
      • 批次執行測試場景
      • 資料驅動測試
      • 共享測試資料
      • 排程任務
      • 管理來自其他專案的 API 執行環境
    • 測試套件
      • 概述
      • 建立測試套件
      • 編排測試套件
      • 在本機執行測試套件
      • 透過 CLI 執行測試套件
      • 排程任務
    • 測試 API
      • 整合測試
      • 效能測試
      • 端對端測試
      • 迴歸測試
      • 契約測試
    • Apidog CLI
      • 概覽
      • 安裝並執行 Apidog CLI
      • Apidog CLI 選項
    • CI/CD
      • 概述
      • 與 Github Actions 整合
      • Integrate with Gitlab
      • 與 Jenkins 整合
      • 透過 Git Commit 觸發測試
  • 發布 API 文件
    • 概述
    • 支援的 API 技術
    • 快速分享
    • 檢視 API 文件
    • Markdown 文件
    • 發佈文件網站
    • 自訂登入頁面
    • 自訂版面配置
    • 自訂 CSS、JavaScript、HTML
    • 自訂網域
    • AI Features
    • SEO 設定
    • 進階設定
      • 文件搜尋
      • CORS Proxy
      • 整合 Google Analytics
      • 資料夾樹設定
      • 可見性設定
      • 在文件 URL 中嵌入值
    • API 版本
      • 概述
      • 建立 API 版本
      • 發佈 API 版本
      • 使用 API 版本分享端點
  • 分支
    • 概觀
    • 建立 Sprint 分支
    • 在分支中測試 API
    • 在分支中設計 API
    • 合併 Sprint 分支
    • 管理 Sprint 分支
    • AI Branch (Beta)
  • AI 功能
    • 概觀
    • 啟用 AI 功能
    • 產生測試案例
    • 使用 AI 修改 Schema
    • 端點合規性檢查
    • API 文件完整性檢查
    • AI 驅動的欄位命名
    • 常見問題
  • Apidog MCP 伺服器
    • 概覽
    • 將 Apidog 專案連接至 AI
    • 將已發布的文件連接至 AI
    • 將 OpenAPI 檔案連接到 AI
  • Apidog Europe
    • Apidog Europe
  • 最佳實務
    • 處理 API 簽章
    • 存取受 OAuth 2.0 保護的 API
    • 協作工作流程
    • 管理驗證狀態
  • 離線空間
    • 概述
  • 管理
    • 管理專案
      • 管理專案
      • 通知設定
      • 管理專案成員
      • 專案資源
        • 資料庫連線
        • Git 連線
    • 管理團隊
      • 管理團隊
      • 管理團隊成員
      • 團隊活動
      • 團隊角色與權限
      • 團隊資源
        • General Runner
        • 團隊變數
        • 請求代理代理程式
      • 即時協作
        • 團隊協作
    • 入門檢查清單
      • 基本概念
      • 入門指南
    • 管理組織
      • 管理組織
      • 組織角色與權限
      • 方案管理
        • 組織中的帳單管理員
      • 單一登入 (SSO)
        • SSO 概覽
        • 設定 Microsoft Entra ID
        • 設定 Okta
        • 為組織設定 SSO
        • 管理使用者帳戶
        • 將群組對應到團隊
      • SCIM 佈建
        • SCIM 佈建簡介
        • Microsoft Entra ID
        • Okta
      • 組織資源
        • 自託管 Runner
  • 帳單
    • 概觀
    • 點數
    • 升級您的方案
    • 替代付款方式
    • 管理訂閱
    • 將付費團隊移至組織
  • 附加元件
    • API Hub
    • Apidog Intellij IDEA 外掛
    • 瀏覽器擴充功能
      • Chrome
      • Microsoft Edge
    • 請求代理
      • Web 中的請求代理
      • 共用文件中的請求代理
      • 用戶端中的請求代理
  • 資料與安全
    • 資料儲存與安全性
    • 使用者資料隱私與安全
    • 請求路由與資料安全
  • 參考
    • API 設計優先方法
    • Apidog OpenAPI 規格擴充
    • JSONPath
    • XPath
    • 正規表示式
    • JSON Schema
    • CSV 檔案格式
    • 安裝 Java 環境
    • Runner 部署環境
    • Apidog Markdown 語法
    • Apidog Swagger 擴充
      • 概述
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 擴充
      • 概述
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 支援中心
  1. 管理專案

通知設定

通知概覽#

Apidog 可讓你與第三方應用程式整合,以便在特定事件發生時向指定接收者傳送通知。當特定事件被觸發時,通知會即時傳送到 Slack 等平台。目前支援的通知渠道包括:
Slack
Teams
Webhook
Jenkins
Email
只有 專案管理員 可以設定通知。目前,電子郵件通知僅適用於以下事件:
自動化測試完成/失敗
持續整合完成/失敗
排程任務完成/失敗

通知目標#

通知目標是指在特定事件發生時,透過特定渠道接收訊息的接收者。
若要設定通知,首先需要透過指定名稱、選擇渠道並設定其選項來建立通知目標。每個渠道都有獨特的設定流程。以下章節將逐步引導你完成設定。
通知設定.png

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」選項。
CleanShot 2024-12-03 at 15.41.54@2x.png
步驟 2:安裝 Incoming WebHook
在特定 Channel 的 Integrations - Apps 中,安裝並新增 Incoming WebHook。
步驟 3:檢視 Incoming WebHooks
安裝完成後,點選 Incoming WebHooks 右側的 View 按鈕。
步驟 4:設定 Incoming WebHooks
這會開啟 Incoming WebHooks 的說明頁面,點選 Configuration 進行設定。
步驟 5:新增到 Slack
點選 Add to Slack。
步驟 6:選擇 Channel 並新增整合
選擇要推送 Apidog 通知事件訊息的 Channel,然後點選 Add Incoming WebHooks integration。
步驟 7:取得 Webhook URL
取得並複製 Webhook URL。
步驟 8:在 Apidog 中建立通知目標
點選「Settings」>「Notifications」>「Notification Targets」>,並建立新的通知 Target。
建立新的 Slack 通知目標.png
填寫通知目標名稱。
選擇 Slack 作為通知渠道。
將從 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 快速開始。
image.png
步驟 2:設定流程名稱與帳戶
為流程設定名稱,選擇適當的帳戶,然後點選 Next。
image.png
步驟 3:選擇群組與頻道
選擇要接收通知的群組與頻道,然後點選 Create flow。
image.png
步驟 4:取得 HTTP POST URL
流程建立後,觸發步驟下方會顯示 HTTP POST URL。你可以直接複製,或稍後在流程的觸發步驟中找到它。
image.png
image.png
步驟 5:在 Apidog 中設定通知目標
將此 HTTP POST URL 貼到 Apidog 的通知目標設定中。
CleanShot 2025-06-10 at 11.55.15@2x.png
步驟 6:建立通知事件
在 Apidog 中建立通知事件,並將其與已設定的 Teams 通知目標關聯。
CleanShot 2025-06-10 at 11.55.59@2x.png
步驟 7:驗證 Teams 通知
當此通知事件被觸發時,先前建立的 workflow 會自動將訊息發布到所選的 Teams 頻道。
image.png

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。
建立新的 Webhook 通知目標.png
1.
填寫通知目標名稱。
2.
選擇 Webhook 作為渠道。
3.
在 Service URL 欄位中貼上自架 HTTP Server 的 URL。
4.
如果已啟用簽章驗證,請將金鑰複製並貼到 Signature Key 欄位。
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。

Jenkins#

支援將通知事件傳送到 Jenkins 服務。透過設定 Jenkins Webhook URL,可將事件訊息傳送到 Jenkins。
設定欄位說明:
設定欄位必填說明
通知名稱否為第三方整合通知命名,以記錄其用途。
觸發事件是API 變更、資料模型變更、匯入資料、自動化測試。當上述任一事件發生時,將觸發即時通知。
服務 URL是此 URL 在 Generic Webhook Trigger 外掛程式中設定。
簽章驗證否透過 Authorization Bearer 標頭傳送到 Generic Webhook Trigger 外掛程式。

將 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"
支援自訂 token:
步驟 2:建立新的通知目標
點選「Settings」>「Notifications」>「Notification Targets」>,並建立新的通知 Target。
Jenkins 通知設定.png
填寫通知目標名稱。
選擇 Jenkins 作為渠道
在 Service URL 欄位中貼上 Generic Webhook Trigger 外掛程式中設定的 Webhook URL
如果使用自訂 token,請將 Token 複製並貼到 Signature Token 欄位。
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。
通知事件設定並觸發後,Jenkins 會自動啟動建置動作,你可以在建置歷史中檢視訊息:

Email#

通知可以透過電子郵件傳送到指定的電子郵件地址。目前,電子郵件通知僅適用於以下事件:
自動化測試完成/失敗
持續整合完成/失敗
排程任務完成/失敗
設定欄位說明:
欄位必填詳細資訊
名稱是描述性名稱,用於突顯通知目標的用途或特性。
通知電子郵件地址是輸入要接收通知的電子郵件地址。你可以選擇專案成員的電子郵件地址,或手動輸入地址。支援多個電子郵件地址。

將 Apidog 通知與 Email 整合#

Email 通知設定.png
1.
填寫通知目標名稱。
2.
選擇 Email 作為渠道
3.
輸入電子郵件
點選 Save 後,設定即完成。現在你可以繼續建立通知事件。

通知事件#

你可以建立通知事件,以指定哪些事件會觸發通知並傳送給指定接收者(通知目標)。若要設定通知事件,需要設定:
通知事件名稱
觸發事件
通知目標
建立通知事件.png

觸發事件#

你可以從下列通知事件中選擇以觸發通知:
觸發事件詳細資訊
端點已變更端點已建立
端點已更新
端點已刪除
Schema 已變更Schema 已建立
Schema 已更新
Schema 已刪除
文件已變更文件已建立
文件已更新
文件已刪除
資料匯入匯入(手動匯入)
匯入(自動同步)
回應元件已變更回應元件已建立
回應元件已更新
回應元件已刪除
Sprint 分支已變更Sprint 分支已合併
Sprint 分支已建立
Sprint 分支已封存
Sprint 分支已刪除
Sprint 分支已取回
API 版本已變更API 版本已建立
API 版本已刪除
安全性方案已變更安全性方案已建立
安全性方案已更新
安全性方案已刪除
TIP
對於與自動化測試相關的通知(例如自動化測試完成、持續整合完成、排程任務完成),你需要針對每個測試情境個別設定。此方式更具彈性,也更符合實際使用案例。

通知目標#

選擇當觸發事件發生時,哪些通知目標會接收通知。你可以從專案中已設定的通知目標中選擇,並可視需要選取多個目標。
不過,電子郵件通知僅支援三種特定事件:
自動化測試完成/失敗
持續整合完成/失敗
排程任務完成/失敗
建立通知事件 - 設定目標.png
Modified at 2026-06-11 10:26:02
Previous
管理專案
Next
管理專案成員
Built with