فاحص نقاط نهاية API
تحدد قواعد CORS الاستجابات والترويسات التي تستطيع هذه الصفحة قراءتها. تتلقى الوجهة الطلب وعنوان IP الخاص بك.
فحوص الاستجابة
- : .
تقرير منقح لطلب واحد
يتضمن التنزيل الطريقة والوجهة بعد حجب التفاصيل والحالة النهائية والمدة ونتائج الفحوص. ويستبعد مسار URL واستعلامه، وترويسات الطلب وجسمه، وجسم الاستجابة وقيم ترويساتها.
أرسل طلب GET أو HEAD أو POST أو PUT أو PATCH أو DELETE من متصفحك وافحص الاستجابة النهائية. يمكنك إضافة فحوص اختيارية لرمز حالة أو نطاق رموز، وترويسة استجابة ظاهرة، وخاصية JSON. يعرض كل فحص إحدى النتائج: ناجح أو فاشل أو غير متاح. تعرض الأداة الحالة النهائية والوقت حتى وصول ترويسات الاستجابة والترويسات الظاهرة للمتصفح وما يصل إلى 1 MiB من نص الاستجابة. لا يُرسل الطلب إلا عندما تختار «إرسال الطلب».
كيفية فحص نقطة نهاية API
-
1
أدخل الطلب
أدخل عنوان URL يبدأ بـ HTTP أو HTTPS واختر الطريقة. أضف ترويسات الطلب أو جسمه إذا احتاجت نقطة النهاية إليها. لا ترسل طريقتا GET وHEAD الجسم الذي أدخلته.
-
2
حدد التوقعات الاختيارية
استخدم رمزا مثل 200 أو نطاقا مثل 200-204 أو فئة مثل 2xx. يمكنك أيضا تسمية ترويسة استجابة ومسار JSON وإضافة قيمة متوقعة اختيارية لأي منهما. اترك الفحص فارغا لتخطيه.
-
3
أرسل الطلب واقرأ النتيجة
اختر «إرسال الطلب» مرة واحدة. اقرأ الحالة النهائية ونتيجة كل فحص. قد تجعل الترويسة المخفية أو الاستجابة التي تتعذر قراءتها أو جسم JSON غير المكتمل نتيجة الفحص «غير متاح».
-
4
احفظ تقريرا منقحا
نزّل تقريرا نصيا أو بصيغة JSON لهذا الفحص. يسجل أصل نقطة النهاية والطريقة والحالة النهائية والمدة والنتائج، ويستبعد مسار URL واستعلامه وقيم الطلب ومحتوى الاستجابة.
مثال على فحص استجابة
لنفترض أن نقطة النهاية التي تملكها GET https://api.example.com/health تعيد الحالة 200 والترويسة الظاهرة Content-Type: application/json والمحتوى {"status":"ready"}. يمكنك إدخال ما يلي:
| الحقل الاختياري | مثال | ما الذي يفحصه |
|---|---|---|
| رموز الحالة المتوقعة | 200, 204 أو 2xx |
هل الحالة النهائية ضمن القيم المحددة؟ |
| اسم ترويسة الاستجابة | Content-Type |
هل يستطيع المتصفح رؤية هذه الترويسة؟ |
| قيمة الترويسة المتوقعة | application/json |
هل تطابق القيمة الظاهرة تماما؟ اتركه فارغا لفحص ظهور الترويسة فقط. |
| مسار خاصية JSON | $.status |
هل توجد هذه الخاصية في استجابة JSON مكتملة؟ |
| قيمة JSON المتوقعة | "ready" |
هل تطابق قيمة JSON بعد تحليلها؟ اتركه فارغا لفحص وجود الخاصية فقط. |
يقبل حقل قيمة JSON صياغة JSON: استخدم true للقيمة المنطقية و42 للعدد و"ready" للنص. تبدأ المسارات بالرمز $ وتدعم الخصائص وفهارس المصفوفات، مثل $.data.items[0].id. لا تشغل شيفرات ولا تدعم المرشحات. إذا غابت خاصية عن JSON قابل للقراءة، يفشل فحصها. أما الترويسة الغائبة أو المخفية بفعل CORS فتكون نتيجتها غير متاح، لأن المتصفح لا يستطيع التمييز بين الحالتين.
ما الذي تثبته النتيجة؟
| النتيجة | المعنى |
|---|---|
| ناجح | الاستجابة النهائية القابلة للقراءة حققت هذا التوقع تحديدا. |
| فاشل | الاستجابة النهائية القابلة للقراءة خالفت هذا التوقع، أو لم تتضمن خاصية JSON المطلوبة. |
| غير متاح | لم يستطع المتصفح تحديد النتيجة، مثلا لتعذر قراءة الاستجابة أو لغياب ترويسة أو إخفائها أو لأن جسم JSON فارغ أو غير مكتمل أو غير صالح. |
يتوقف المؤقت عند وصول ترويسات الاستجابة، ولا يقيس تنزيل الجسم بالكامل. تنتهي مهلة الطلب بعد 15 ثانية؛ يقتصر جسم الطلب على 1 MiB وتتوقف معاينة الاستجابة بعد 1 MiB. لا تتيح المعاينة المقتطعة تحديد نتيجة خاصية JSON. لا تحتوي استجابات HEAD و204 على جسم يمكن فحصه، ولذلك تكون نتيجة فحص JSON «غير متاح». تتبع الأداة عمليات إعادة التوجيه وتعرض عنوان URL النهائي، لكنها لا تعرض كل خطوة ولا تكرر الطلب تلقائيا. قد تمنع قواعد CORS قراءة الاستجابة رغم وصول الطلب إلى نقطة النهاية. وقد يرسل المتصفح أيضا طلب تمهيد CORS قبل الطريقة المطلوبة.
لا يمكن فحص إلا ترويسات الاستجابة التي يكشفها المتصفح. قد تحتاج نقطة النهاية إلى إدراج الترويسة المخصصة ضمن Access-Control-Expose-Headers. قد تكون الترويسة غير الظاهرة في هذه الصفحة غائبة عن الخادم أو مخفية بفعل CORS. ارجع إلى سجلات الخادم أو استخدم عميلا مناسبا لواجهات API إذا احتجت إلى التمييز بين الحالتين.
الأسئلة الشائعة
تعني «فاشل» أن استجابة يستطيع المتصفح قراءتها خالفت توقعك. وتعني «غير متاح» أن المتصفح لم يستطع تحديد النتيجة. مثلا، لا يستطيع معرفة ما إذا كانت ترويسة الاستجابة غير الظاهرة غائبة أو مخفية بفعل CORS، ولا فحص JSON داخل جسم فارغ أو غير قابل للقراءة أو مقتطع.
يمكنك إدخال ترويسة Authorization إذا سمحت نقطة النهاية بطلب المتصفح هذا عبر CORS. لا يرسل الفاحص ملفات تعريف ارتباط المتصفح أو بيانات اعتماد أخرى يضيفها المتصفح تلقائيا. تذهب قيمة الترويسة مباشرة إلى الوجهة، فاستخدم بيانات الاعتماد فقط مع نقطة نهاية تثق بها.
يرسل متصفحك الطلب مباشرة إلى الوجهة، فتتلقى الطلب وعنوان IP الخاص بك. لا تمر المعلومات التي تدخلها، وهي عنوان URL والترويسات وجسم الطلب، عبر خوادم هذا الموقع، ولا تظهر في عنوان صفحة الأداة. يحتفظ التقرير المنقح بأصل نقطة النهاية، لكنه يستبعد بقية عنوان URL وترويسات الطلب وجسمه. للانتقال بين الخطوات، يحفظ الفاحص مدخلاتك لفترة وجيزة في تخزين جلسة علامة التبويب نفسها. يقبل السجل لمدة لا تتجاوز خمس دقائق ويحذفه عند قراءته أو عندما تبدأ من جديد أو بعد الفحص. يمكن للبرامج النصية على هذا الموقع قراءة السجل أثناء وجوده. إذا منع متصفحك التخزين، يمكنك إرسال الطلب من الصفحة نفسها.
يُنشأ تقرير نصي أو بصيغة JSON للفحص الحالي. يتضمن أصل نقطة النهاية والطريقة والحالة النهائية والوقت حتى وصول ترويسات الاستجابة وعدد البايتات المحفوظة وعلامتي إعادة التوجيه والاقتطاع ونتائج الفحوص. ويستبعد مسار URL واستعلامه وجزءه اللاحق، وترويسات الطلب وقيمها وجسمه، وترويسات الاستجابة وقيمها وجسمها. راجع الملف قبل مشاركته؛ فقد يكشف الأصل والنتائج عن هوية خدمتك.
يبدأ المؤقت قبل أن يبدأ المتصفح Fetch مباشرة، ويتوقف عند وصول ترويسات الاستجابة النهائية. يشمل وقت المتصفح والشبكة وأي عمليات إعادة توجيه مسموحة، لكنه لا يشمل قراءة الجسم. قد تقيس سجلات الخادم فترة مختلفة.
لا. يجري «إرسال الطلب» فحصا عندما تختاره. لا تجدول الأداة الطلبات ولا تكررها تلقائيا ولا تراقبها. ومع ذلك، قد تضيف طلبات تمهيد CORS وإعادة التوجيه المتبعة طلبات شبكة أخرى خلال فحص واحد.
أدوات ذات صلة
ماسح المنافذ المفتوحة
افحص قائمة ثابتة من منافذ TCP الشائعة على مضيف عام لمعرفة أي منها مفتوح وأي الخدمات يمكن الوصول إليها. فحص سريع وأساسي، وليس ماسحًا كاملًا.
حاسبة CIDR
احسب كتلة CIDR بصيغة IPv4 أو IPv6 بعد ضبط عنوان الشبكة، وأول عنوان وآخر عنوان والعدد الدقيق للعناوين، مع أقنعة IPv4 وقواعد الوصلات من نقطة إلى نقطة.
أداة التحقق من موقع الخادم
ابحث عن مركز البيانات المادي، والدولة، ورمز ASN، ومزوّد الحوسبة السحابية الكامن وراء أي نطاق. ويكتشف خدمات مثل Cloudflare وFastly وAkamai وغيرها من مزودي شبكات توزيع المحتوى (CDN).
فاحص تعطل المواقع
تحقق مما إذا كان الموقع يستجيب من خادم مستقل. يعرض حالة UP أو DOWN ورمز حالة HTTP وزمن الاستجابة وعنوان IP للخادم، لتمييز العطل الحقيقي عن مشكلة في شبكتك المحلية.
أداة فحص شهادات SSL
افحص شهادة SSL/TLS التي يقدّمها مضيف على المنفذ 443: الموضوع والجهة المُصدِرة وتواريخ الصلاحية والأيام حتى انتهائها وأسماء SAN وخوارزمية التوقيع.
فاحص DKIM
أدخل النطاق ومُحدِّد DKIM لفحص المفتاح العام المنشور في سجل TXT بنظام DNS. اطّلع على السجل ونوع المفتاح وحالته.
الأداة متاحة بلغات أخرى
- Verificador de endpoint de API [PT]
- Trình kiểm tra endpoint API [VI]
- API 엔드포인트 검사기 [KO]
- Pemeriksa Endpoint API [ID]
- APIエンドポイントチェッカー [JA]
- Kontrollera API-endpoint [SV]
- ตรวจสอบ API endpoint [TH]
- API-endpointchecker [NL]
- Verificador de endpoints de API [ES]
- Vérificateur de point de terminaison API [FR]
- API-Endpunkt-Prüfer [DE]
- Tester endpointu API [PL]
- API 端点检查器 [ZH]
- API Endpoint Checker [EN]
- Controllo degli endpoint API [IT]
- Проверка API-эндпоинта [RU]
- API endpoint kontrolü [TR]