# 모니터링 연동 API 레퍼런스

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

REST API로 외부 모니터링 연동을 프로그램에서 만들 수 있습니다.

## 연동 만들기

**엔드포인트:**

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

**본문 파라미터**

| 필드 | 유형 | 설명 |
| ----- | ---- | ----------- |
| `pageId` | `string` | 상태 페이지의 ID |
| `integrationType` | `string` | 연동 유형입니다. 예: `PINGDOM`, `NEWRELIC` |
| `components` | `string[]` | 연결할 구성 요소의 ID |

**요청 예시**

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

**응답 예시**

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

이 엔드포인트는 [`MonitoringTool` enum](https://github.com/instatushq/instatus/blob/master/packages/backend/prisma/schema.prisma)에 있는 모든 모니터링 도구를 지원합니다.

## 연동 업데이트하기

**엔드포인트:**

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

생성 엔드포인트의 필드를 아무거나 보내거나, 새 템플릿 데이터를 제공해 인시던트 생성과 해결 방식을 맞춤 설정하세요.

**요청 예시**

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

**응답 예시**

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

## 연동 삭제하기

**엔드포인트:**

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

**응답 예시**

```json
{}
```