Referencia de la API de integraciones de monitorización

Puedes crear integraciones de monitorización de terceros mediante programación con la API REST.

Crear una integración

Endpoint:

POST /v3/integrations

Parámetros del cuerpo

Campo	Tipo	Descripción
pageId	string	ID de la página de estado
integrationType	string	Tipo de integración; por ejemplo, PINGDOM, NEWRELIC
components	string[]	ID de los componentes que se asocian

Petición de ejemplo

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

Respuesta de ejemplo

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

Este endpoint acepta cualquier herramienta de monitorización incluida en nuestro enum MonitoringTool.

Actualizar una integración

Endpoint:

PUT /v3/integrations/:integration_id

Envía cualquiera de los campos del endpoint de creación o aporta datos de plantilla nuevos para personalizar la creación y la resolución de incidencias.

Petición de ejemplo

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

Respuesta de ejemplo

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

Eliminar una integración

Endpoint:

DELETE /v3/integrations/:integration_id

Respuesta de ejemplo

{}