مختبِر نقاط نهاية API

بمساعدة الخادم اختبار واجهات API

أدخل عنوان URL عاماً لتحصل فوراً على اختبار سريع (smoke test): حالة HTTP، وتفصيل زمن الاستجابة، وحجم الاستجابة، ونوع المحتوى، وترويسات الخادم، وسلوك إعادة التوجيه.

الخصوصية: ترسل هذه الأداة الطلب عبر خادم متقن للوصول إلى الهدف. يُنقل فقط العنوان والترويسات والمحتوى الذي تدخله، ولا يُحفظ أي شيء.

ما هو اختبار واجهات API؟

اختبار واجهات API يفحص الخدمة عبر واجهتها لا عبر شاشاتها: أرسل طلباً بأسلوب وترويسات وجسم مختارة، ثم تحقق من رمز الحالة وترويسات الاستجابة وبنية الجسم وقيمه والوقت المستغرق. ولأنه يعمل تحت واجهة المستخدم، فهو أسرع وأكثر استقراراً ويكشف عيوب التكامل مبكراً — ولهذا تُبنى حزم الانحدار على مستوى API أولاً.

اقرأ الدليل: ما هو اختبار API؟ وكيف تختبر REST API

كيفية استخدام مختبِر نقاط نهاية API

  1. الصق عنوان URL لنقطة النهاية (http/https عام).
  2. اختيارياً اختر الطريقة، أو عطّل تتبّع إعادة التوجيه، أو أضف ترويسات مثل Authorization.
  3. شغّل الاختبار واقرأ الإحصاءات ولوحة التفاصيل وجدول الترويسات.
  4. نزّل الترويسات بصيغة CSV أو معاينة الجسم لإرفاقها بتقرير خلل.

مزايا مختبِر نقاط نهاية API

  • اختبار سريع بنقرة واحدة: الحالة والزمن الإجمالي وزمن الوصول إلى أول بايت والحجم ونوع المحتوى
  • فحص دعم HEAD، وسلسلة إعادة التوجيه، وعنوان URL النهائي، وملاحظات TLS/HSTS
  • إبراز ترويسات التخزين المؤقت والضغط وCORS وتحديد المعدّل مع شرح لكل منها
  • جدول ترويسات يوضّح معنى كل ترويسة بلغة مبسّطة
  • معاينة الجسم مع تنسيق تلقائي لمحتوى JSON/XML/HTML

مثال على مختبِر نقاط نهاية API

اختبار سريع لنقطة نهاية JSON

الإدخال:

https://httpbin.org/get?ping=1

النتيجة:

Status 200 · Total 380 ms (TTFB 210 ms) · 420 B · application/json
Reachable: Yes · TLS: HTTPS (no HSTS) · Server: gunicorn/19.9.0 · CORS: * · HEAD support: 200 in 190 ms

الأسئلة الشائعة حول مختبِر نقاط نهاية API

ماذا يفحص الاختبار السريع؟

يرسل طلب HEAD ثم طلب GET (أو الطريقة التي تختارها) عبر المُرحِّل، ويبلّغ عن الحالة والزمن الإجمالي وزمن الوصول إلى أول بايت والحجم ونوع المحتوى وTLS/HSTS وعمليات إعادة التوجيه وترويسات التخزين المؤقت والضغط وCORS وتحديد المعدّل.

هل يمكنني اختبار نقاط نهاية تتطلب رمزاً؟

نعم — أضف ترويسة Authorization في حقل الترويسات الإضافية. تُستخدم الترويسات لهذا التشغيل فقط ولا تُخزَّن.

لماذا تظهر معاينة الجسم مقتطعة؟

تعرض المعاينة 20 000 حرف على الأكثر لتبقى الصفحة سريعة الاستجابة؛ نزّل مخرجات الجسم للحصول على النص الكامل (علماً بأن المُرحِّل نفسه يحدّ من الأجسام الكبيرة جداً).

هل يمكنه الوصول إلى عناوين داخلية أو localhost؟

لا. يصل المُرحِّل إلى نقاط نهاية http(s) العامة فقط. للخدمات المحلية استخدم منشئ طلبات API في وضع المتصفح المباشر.

ملاحظات تقنية

في طلبات GET، يُجرَّب طلب HEAD أولاً لقياس زمن الاستجابة للترويسات وحدها وتأكيد دعم HEAD، ثم يُرسل الطلب الفعلي. يمرّ كلاهما عبر المُرحِّل الذي يتوقف عن الانتظار بعد 15 ثانية.

المراجع

  • RFC 9110: HTTP SemanticsIETF · 2022معاني أساليب HTTP وحقول الترويسات ورموز الحالة والتفاوض على المحتوى، بغضّ النظر عن إصدار البروتوكول.
  • OpenAPI SpecificationOpenAPI Initiativeالمعيار لوصف واجهات REST: المسارات والعمليات والمعاملات والمخططات والاستجابات وأنظمة الأمان.
  • OWASP Cheat Sheet Series: REST SecurityOWASP Foundationالقواعد الأمنية لواجهات REST: HTTPS، والتوثيق في كل طلب، والتحقق من المدخلات، واستجابات الخطأ الآمنة، وتحديد المعدل.