# مراقبة API

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

ترسل مراقبات API طلب HTTP قابلًا للضبط إلى نقطة نهاية كل ٣٠ ثانية، وتنبّهك عندما يتعذر الوصول إليها أو تستجيب ببطء أو تعيد بيانات خاطئة. يمكنك التحكم في الطريقة والترويسات والمحتوى والمصادقة، والتأكد من رمز الحالة ومحتوى JSON والترويسات وزمن الاستجابة.

مثل [المراقبات الأخرى](https://instatus.com/help/ar/monitoring)، إذا اكتشفت مراقبة API مشكلة، يمكنك العمل مع فريقك [لحل الحادثة](https://instatus.com/help/ar/incident-response) وتحديث [صفحة الحالة](https://instatus.com/help/ar/status-page) إن أردت.

| At a glance | Details |
| :-- | :-- |
| [تكرار الفحص](https://instatus.com/help/ar/monitoring/api#إعدادات-متقدمة) | كل ٣٠ ثانية |
| [طرق HTTP](https://instatus.com/help/ar/monitoring/api#ضبط-الطلب) | GET، POST، PUT، PATCH، DELETE، OPTIONS، HEAD |
| [محتوى الطلب](https://instatus.com/help/ar/monitoring/api#ضبط-الطلب) | JSON، بيانات نموذج، GraphQL، نص عادي |
| [المصادقة](https://instatus.com/help/ar/monitoring/api#ضبط-الطلب) | مصادقة أساسية، مفتاح API، رمز Bearer |
| [التأكيدات](https://instatus.com/help/ar/monitoring/api#يُعتبر-المراقبة-ناجحًا-إذا) | رمز الحالة، زمن الاستجابة، المحتوى، مسار JSON، الترويسات |
| [مواقع الفحص](https://instatus.com/help/ar/monitoring/api#إعدادات-متقدمة) | الولايات المتحدة، كندا، أوروبا، آسيا |

![مراقبة](https://instatus.com/help/monitors/item.png)

## ما الذي تفحصه مراقبة API؟

- اختبار نقاط نهاية API من مواقع عالمية متعددة كل ٣٠ ثانية.
- التحقق من رموز حالة HTTP ومحتوى JSON والترويسات وأزمنة الاستجابة.
- تضمين ترويسات مخصصة أو معاملات استعلام أو حمولات JSON.
- تلقي إشعارات فورية إذا كانت نقطة النهاية متوقفة أو بطيئة أو تعيد نتائج غير متوقعة.
- التكامل مع Slack والبريد الإلكتروني والرسائل القصيرة والمكالمات الهاتفية والويب هوك وغيرها.

## كيف أضيف مراقبة API؟

انتقل إلى مشروعك ← المراقبات ← إضافة مراقبة، واختر **API**، وأدخل رابط نقطة النهاية، واضبط الطلب، ثم حدد التأكيدات التي تعني أن نقطة النهاية تعمل بشكل سليم.

![إضافة مراقبة 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`
- **زمن الاستجابة:** مثلًا أقل من `1 second`
- **المحتوى يتضمن:** مثلًا `"success": true`
- **مسار JSON:** مثلًا أن يساوي `data.status` القيمة `"active"`
- **الترويسة تتضمن:** مثلًا `Content-Type: application/json`

إذا لم يتحقق أي من هذه الشروط، ستُعتبر المراقبة **متوقفة**، وستُرسل التنبيهات بناءً على [إعدادات التنبيهات](https://instatus.com/help/ar/monitoring/alerts) لديك.

### إعدادات متقدمة

![إعدادات المراقبة المتقدمة](https://instatus.com/help/monitors/advanced-settings.png)

- **اسم مألوف:** امنح مراقبتك اسمًا وصفيًا لتسهيل التعرف عليها.
- **تشغيل الفحوصات كل:** حدد عدد مرات اختبار نقطة النهاية.
- **التشغيل من:** اختر مواقع الاختبار (الولايات المتحدة، كندا، أوروبا، آسيا).
- **إضافة إلى صفحة الحالة:** اعرض مدة تشغيل API وإحصاءات الاستجابة علنًا.
- **عند فشل المراقبة:** ابدأ حادثة، أو أشعِر المشتركين، أو انشرها في صفحة الحالة.
- **عند تعافي المراقبة:** حل الحوادث وحدّث صفحة الحالة تلقائيًا.

تهانينا، لقد أضفت أول مراقبة API لديك!

- [مراقبة Cron](https://instatus.com/help/ar/monitoring/cron): تعلّم كيفية مراقبة المهام المجدولة والمهام التي تعمل في الخلفية