# نظارت بر API

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

مانیتورهای API هر ۳۰ ثانیه یک درخواست HTTP قابل پیکربندی به یک نقطه پایانی می‌فرستند و وقتی در دسترس نباشد، کند باشد یا داده نادرست برگرداند به شما هشدار می‌دهند. متد، هدرها، بدنه و احراز هویت در اختیار شماست و می‌توانید کد وضعیت، بدنه JSON، هدرها و زمان پاسخ را بسنجید.

مانند [سایر مانیتورها](https://instatus.com/help/fa/monitoring)، اگر مانیتور API مشکلی را شناسایی کند، می‌توانید با تیمتان برای [حل حادثه](https://instatus.com/help/fa/incident-response) کار کنید و به‌دلخواه [صفحه وضعیت](https://instatus.com/help/fa/status-page) خود را به‌روزرسانی کنید.

| At a glance | Details |
| :-- | :-- |
| [بازه بررسی](https://instatus.com/help/fa/monitoring/api#تنظیمات-پیشرفته) | هر ۳۰ ثانیه |
| [متدهای HTTP](https://instatus.com/help/fa/monitoring/api#پیکربندی-درخواست) | GET، POST، PUT، PATCH، DELETE، OPTIONS، HEAD |
| [بدنه درخواست](https://instatus.com/help/fa/monitoring/api#پیکربندی-درخواست) | JSON، داده فرم، GraphQL، متن ساده |
| [احراز هویت](https://instatus.com/help/fa/monitoring/api#پیکربندی-درخواست) | Basic auth، کلید API، توکن Bearer |
| [شرط‌ها](https://instatus.com/help/fa/monitoring/api#مانیتور-موفق-است-اگر) | کد وضعیت، زمان پاسخ، بدنه، مسیر JSON، هدرها |
| [موقعیت‌های بررسی](https://instatus.com/help/fa/monitoring/api#تنظیمات-پیشرفته) | ایالات متحده، کانادا، اروپا، آسیا |

![مانیتور](https://instatus.com/help/monitors/item.png)

## مانیتور API چه چیزی را بررسی می‌کند؟

- آزمودن نقاط پایانی API از موقعیت‌های گوناگون در سراسر جهان، هر ۳۰ ثانیه.
- اعتبارسنجی کدهای وضعیت HTTP، بدنه JSON، هدرها و زمان پاسخ.
- افزودن هدرهای سفارشی، پارامترهای پرس‌وجو یا محتوای JSON.
- دریافت اعلان فوری در صورت قطع بودن، کند بودن یا برگرداندن نتیجه غیرمنتظره توسط یک نقطه پایانی.
- یکپارچه‌سازی با Slack، ایمیل، پیامک، تماس تلفنی، وب‌هوک و موارد دیگر.

## چگونه مانیتور API اضافه کنم؟

به پروژه خود → مانیتورها → افزودن مانیتور بروید، **API** را انتخاب کنید، URL نقطه پایانی را وارد کنید، درخواست را پیکربندی کنید و شرط‌هایی را تعیین کنید که نشان می‌دهند نقطه پایانی سالم است.

![افزودن مانیتور API](https://instatus.com/help/monitors/API.png)

### نوع مانیتور

**API** را به‌عنوان نوع مانیتور انتخاب کنید.

![نوع مانیتور API](https://instatus.com/help/monitors/type-api.png)

نشانی نقطه پایانی مورد نظر را وارد کنید — برای نمونه،  
`https://api.yourservice.com/v1/users`.

### پیکربندی درخواست

می‌توانید درخواست API خود را کاملاً سفارشی کنید:

- **روش HTTP:** `GET`، `POST`، `PUT`، `PATCH`، `DELETE`، `OPTIONS` یا `HEAD`
- **بدنه:** همراه درخواست، JSON، داده فرم، GraphQL یا متن ساده بفرستید
- **احرازهویت:** احرازهویت پایه، کلید API یا مجوز توکن Bearer اضافه کنید
- **پارامترهای پرس‌وجو:** جفت‌های کلید/مقدار را به نشانی درخواست بیفزایید
- **هدرها:** هدرهای سفارشی لازم برای درخواست API خود را اضافه کنید

### مانیتور موفق است اگر

مانیتور API زمانی موفق است که همه گزاره‌های مشخص‌شده برآورده شوند.  
می‌توانید یک یا چند مورد از گزاره‌های زیر را تنظیم کنید:

- **کد وضعیت:** مثلاً پاسخ `200 OK` باشد
- **زمان پاسخ:** مثلاً کمتر از `۱ ثانیه`
- **بدنه شامل باشد:** مثلاً `"success": true`
- **مسیر JSON:** مثلاً `data.status` برابر `"active"` باشد
- **هدر شامل باشد:** مثلاً `Content-Type: application/json`

اگر هر یک از این شرط‌ها برقرار نباشد، مانیتور **قطع** علامت می‌خورد و هشدارها بر اساس [تنظیمات هشدار](https://instatus.com/help/fa/monitoring/alerts) شما فرستاده می‌شوند.

### تنظیمات پیشرفته

![تنظیمات پیشرفته مانیتور](https://instatus.com/help/monitors/advanced-settings.png)

- **نام نمایشی:** نامی گویا به مانیتورتان بدهید تا شناسایی‌اش آسان‌تر باشد.
- **اجرای بررسی‌ها هر:** تعیین کنید نقطه پایانی هر چند وقت آزموده شود.
- **اجرا از:** موقعیت‌های آزمون را انتخاب کنید (ایالات متحده، کانادا، اروپا، آسیا).
- **افزودن به صفحه وضعیت:** زمان فعالیت و آمار پاسخ API را عمومی نمایش دهید.
- **وقتی مانیتور دچار خطا می‌شود:** حادثه‌ای آغاز کنید، به مشترکان اطلاع دهید یا در صفحه وضعیت منتشر کنید.
- **وقتی مانیتور بازیابی می‌شود:** حوادث را حل کنید و صفحه وضعیت را به‌صورت خودکار به‌روزرسانی کنید.

تبریک، اولین مانیتور API خود را اضافه کردید!

- [نظارت بر Cron](https://instatus.com/help/fa/monitoring/cron): یاد بگیرید چگونه کارهای زمان‌بندی‌شده و فرایندهای پس‌زمینه را زیر نظر بگیرید