監控整合 API 參考

你可以透過 REST API 以程式方式建立第三方監控整合。

建立整合

端點:

POST /v3/integrations

內容參數

欄位型別說明
pageIdstring狀態頁的 ID
integrationTypestring整合類型,例如 PINGDOMNEWRELIC
componentsstring[]要附加的元件 ID

請求範例

{
"pageId": "page123",
"integrationType": "PINGDOM",
"components": ["component1", "component2"]
}

回應範例

{
"integration": {
"id": "int_abc",
"monitoringTool": "PINGDOM"
},
"message": "Integration created successfully."
}

這個端點接受我們的 MonitoringTool enum 中列出的任何監控工具。

更新整合

端點:

PUT /v3/integrations/:integration_id

你可以送出建立端點中的任何欄位,或提供新的範本資料來自訂事件的建立與解決方式。

請求範例

{
"label": "Pingdom Primary",
"createTemplate": { "name": "New incident" },
"resolveTemplate": { "name": "Incident resolved" }
}

回應範例

{
"integration": {
"id": "int_abc",
"label": "Pingdom Primary"
}
}

刪除整合

端點:

DELETE /v3/integrations/:integration_id

回應範例

{}