# مرجع API یکپارچه‌سازی‌های نظارتی

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

می‌توانید یکپارچه‌سازی‌های نظارتی شخص ثالث را به‌صورت برنامه‌نویسی با REST API بسازید.

## ساخت یکپارچه‌سازی

**نقطه پایانی:**

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

**پارامترهای بدنه**

| فیلد | نوع | توضیح |
| ----- | ---- | ----------- |
| `pageId` | `string` | شناسه صفحه وضعیت |
| `integrationType` | `string` | نوع یکپارچه‌سازی، مثلاً `PINGDOM`، `NEWRELIC` |
| `components` | `string[]` | شناسه اجزایی که باید متصل شوند |

**نمونه درخواست**

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

**نمونه پاسخ**

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

این نقطه پایانی هر ابزار نظارتی فهرست‌شده در [enum ما با نام `MonitoringTool`](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
{}
```