# Tài liệu tham khảo API Tích hợp giám sát

Source: https://instatus.com/help/vi/api/monitoring-integrations

Bạn có thể tạo các tích hợp giám sát bên thứ ba bằng chương trình thông qua REST API.

## Tạo tích hợp

**Endpoint:**

```bash
POST /v3/integrations
```

**Tham số body**

| Trường | Kiểu | Mô tả |
| ----- | ---- | ----------- |
| `pageId` | `string` | ID của trang trạng thái |
| `integrationType` | `string` | Loại tích hợp, ví dụ `PINGDOM`, `NEWRELIC` |
| `components` | `string[]` | ID của các thành phần cần gắn vào |

**Yêu cầu ví dụ**

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

**Phản hồi ví dụ**

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

Endpoint này chấp nhận mọi công cụ giám sát có trong [enum `MonitoringTool`](https://github.com/instatushq/instatus/blob/master/packages/backend/prisma/schema.prisma) của chúng tôi.

## Cập nhật tích hợp

**Endpoint:**

```bash
PUT /v3/integrations/:integration_id
```

Gửi bất kỳ trường nào từ endpoint tạo mới, hoặc cung cấp dữ liệu mẫu mới để tùy chỉnh việc tạo và khắc phục sự cố.

**Yêu cầu ví dụ**

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

**Phản hồi ví dụ**

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

## Xóa tích hợp

**Endpoint:**

```bash
DELETE /v3/integrations/:integration_id
```

**Phản hồi ví dụ**

```json
{}
```