محلّل استجابات API

تعمل في المتصفح اختبار واجهات API

الصق استجابة JSON للحصول على تقرير بنيوي — عدد المفاتيح، وعمق التداخل، وتوزيع الأنواع، والحقول الفارغة وذات القيمة null، والأنواع غير المتسقة بين عناصر المصفوفات، وصيغ التواريخ والمعرّفات، ومقاييس الحجم.

الخصوصية: تعمل هذه الأداة بالكامل في متصفحك. لا تغادر بياناتك جهازك أبداً.

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

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

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

كيفية استخدام محلّل استجابات API

  1. الصق جسم استجابة JSON.
  2. اضغط «تحليل».
  3. اقرأ قائمة النتائج أولاً، ثم تعمّق في الجداول (الأنواع غير المتسقة والصيغ والحقول الفارغة).
  4. شارك ملفات CSV مع مالك واجهة API أو أرفقها بتقرير خلل.

مزايا محلّل استجابات API

  • نظرة عامة: نوع الجذر وعدد المفاتيح والعمق والكائنات/المصفوفات/قيم null والحجم المنسّق مقابل المصغّر
  • نتائج جودة البيانات: قيم null، والحقول الفارغة، والأنواع غير المتسقة بين عناصر المصفوفات، والأعداد/القيم المنطقية المرسلة كسلاسل نصية، وصيغ المعرّفات والطوابع الزمنية المختلطة، والتكرارات، والتداخل العميق
  • توزيع الأنواع وصيغ القيم المكتشفة (uuid وemail وurl وتواريخ ISO وطوابع Unix الزمنية وIP وJWT…)
  • أكبر المصفوفات وأطول السلاسل النصية والمفاتيح الأكثر تكراراً
  • يعمل محلياً؛ مع تنزيل CSV لكل جدول

مثال على محلّل استجابات API

اكتشاف الحقول غير المتسقة

الإدخال:

{ "data": [ { "id": "usr_1001", "age": 29, "createdAt": "2025-03-01T10:15:00Z" }, { "id": 1002, "age": "31", "createdAt": 1740823200 } ] }

النتيجة:

2 fields with inconsistent types across array items — $.data[*].id (string, number), $.data[*].age (number, string)
Timestamps mix Unix epoch numbers and ISO-8601 strings — pick one representation.

الأسئلة الشائعة حول محلّل استجابات API

ما المشكلات التي يكتشفها؟

الحقول ذات القيمة null والحقول الفارغة، والحقول التي يتغيّر نوعها بين عناصر المصفوفة، والأعداد والقيم المنطقية المرسلة كسلاسل نصية، وصيغ المعرّفات المختلطة، وتمثيلات الطوابع الزمنية المختلطة، وعناصر المصفوفات المكرّرة، والتداخل العميق، والمصفوفات المفرطة الحجم.

هل يرسل استجابتي إلى أي مكان؟

لا، يجري التحليل بالكامل في متصفحك.

كيف تُكتشف الصيغ؟

عبر أنماط القيم وأسماء المفاتيح: معرّفات UUID، وعناوين البريد الإلكتروني، وعناوين URL، وتواريخ ISO والتواريخ مع الوقت، وطوابع Unix الزمنية (بالثواني/الملّي ثانية)، وعناوين IP، ورموز JWT، وكتل Base64، والسلاسل النصية الشبيهة بالمعرّفات.

هل يوجد حدّ للحجم؟

تُقبل المستندات حتى 2 ميغابايت؛ ويتوقف التحليل بعد 200 000 عقدة ويخبرك إن حدث ذلك.

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

تُوحَّد المسارات ذات فهارس المصفوفات إلى الصيغة [*] حتى يُقارن الحقل نفسه عبر العناصر. ويجمع اكتشاف الصيغ بين أنماط القيم وأسماء المفاتيح (فمثلاً يُعامل عدد من 10 أرقام باسم createdAt على أنه طابع Unix زمني).

المراجع

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