مختبِر نقاط نهاية API
أرسل طلبًا واحدًا إلى نقطة نهاية API عامة من خادمنا واطّلع على رمز حالة HTTP الذي تُرجعه، والمدة التي استغرقها، وما إذا كان يُعدّ نجاحًا. إنها طريقة سريعة للتأكد من أن نقطة النهاية تعمل ويمكن الوصول إليها من الإنترنت.
ما الذي تفحصه هذه الأداة
رمز الحالة
حالة HTTP التي تُرجعها نقطة النهاية، بعد تتبع ما يصل إلى 5 عمليات إعادة توجيه.
زمن الاستجابة
زمن الرحلة الكاملة ذهابًا وإيابًا من خادمنا بالملّي ثانية، بما في ذلك البحث في DNS وإنشاء الاتصال وأي عمليات إعادة توجيه.
النجاح أو الفشل
ينجح الطلب عندما تكون الحالة النهائية أقل من 400. وتُعرض حالات انتهاء المهلة (بعد 15 ثانية) وفشل الاتصال والعناوين المحظورة كأخطاء.
كيف يعمل الفحص
يرسل خادمنا الطلب بالطريقة والترويسات والمحتوى الذي تدخله. يُرسل المحتوى تمامًا كما كتبته، لذا أضف ترويسة Content-Type إذا كانت API تتوقع JSON أو بيانات نموذج. ولا يُعرض محتوى الاستجابة ولا يُحتفظ به.
حفاظًا على الأمان، لا يمكن اختبار إلا عناوين الإنترنت العامة. أما العناوين على الشبكات الخاصة — localhost و10.x.x.x و192.168.x.x وخدمات البيانات الوصفية السحابية وما شابهها — فهي محظورة، وتُفحص كل عملية إعادة توجيه بالطريقة نفسها.
تحتاج إلى حساب مجاني لاستخدام المختبِر، والطلبات محدودة لكل شبكة. نحفظ مع حسابك عنوان URL لنقطة النهاية والطريقة ورمز الحالة وزمن الاستجابة وأي خطأ؛ ولا تُحفظ الترويسات والمحتوى.
مشكلات شائعة نكتشفها
401 أو 403
نقطة النهاية تتطلب مصادقة، أو المفتاح أو الرمز المرسل غير مسموح به.
404 Not Found
مسار خاطئ، أو غياب بادئة الإصدار مثل /v1، أو شرطة مائلة في النهاية لا تتوقعها API.
405 Method Not Allowed
نقطة النهاية موجودة لكنها لا تقبل هذه الطريقة — مثل إرسال POST إلى مورد للقراءة فقط.
400 أو 415
المحتوى مشوّه، أو ترويسة Content-Type مفقودة أو خاطئة.
429 Too Many Requests
تم بلوغ حد الطلبات الخاص بـ API نفسها.
أخطاء 5xx وانتهاء المهلة
API متوقفة، أو محمّلة فوق طاقتها، أو تستغرق أكثر من 15 ثانية للاستجابة.
كيفية إصلاحها
أرسل بيانات الاعتماد الصحيحة
أضف ترويسة Authorization بالصيغة الموثقة في API، مثل Authorization: Bearer متبوعة برمزك. واستخدم مفتاح اختبار بدلًا من مفتاح سري للإنتاج.
قارن المسار بالتوثيق
قارن عنوان URL بمرجع API، بما في ذلك بادئات الإصدار والشرطات المائلة في النهاية ومعاملات الاستعلام.
طابق المحتوى مع Content-Type
بالنسبة إلى JSON، أرسل JSON صالحًا مع الترويسة Content-Type: application/json.
تحقّق من سبب بطء الاستجابات
تشير أزمنة الاستجابة التي تبلغ عدة ثوانٍ عادةً إلى استعلامات قاعدة بيانات بطيئة، أو بدء تشغيل بارد في الاستضافة بلا خادم (serverless)، أو خادم بعيد عن موقعنا.
الأسئلة الشائعة
لماذا أحتاج إلى حساب؟
يُرسل الطلب من خادمنا إلى عنوان تختاره أنت. واشتراط حساب مجاني وتحديد عدد الطلبات يمنعان استخدام المختبِر لإرسال زيارات مجهولة إلى خوادم الآخرين.
هل يمكنني اختبار localhost أو API داخلية؟
لا. العناوين الخاصة والداخلية محظورة عمدًا، حتى لا يُستخدم المختبِر للوصول إلى شبكتنا الداخلية. لاختبار API محلية، استخدم أداة تعمل على جهازك.
لماذا لا أستطيع رؤية محتوى الاستجابة؟
يبلّغ المختبِر عمّا إذا كان يمكن الوصول إلى نقطة النهاية ومدى سرعة استجابتها. ولا يعرض محتوى الاستجابة ولا يحتفظ به.
هل تُخزَّن مفاتيح API الخاصة بي؟
تُرسل الترويسات ومحتوى الطلب إلى نقطة النهاية لكنها لا تُحفظ. أما عنوان URL لنقطة النهاية فيُحفظ مع النتيجة، لذا لا تضع بيانات سرية في سلسلة الاستعلام الخاصة بعنوان URL.
لماذا يختلف زمن الاستجابة عمّا أراه محليًا؟
لأنه يُقاس من خادمنا لا من جهازك، فتختلف المسافة والتوجيه وإنشاء الاتصال. وهو الأنسب لمقارنة نقطة النهاية بنفسها مع مرور الوقت.
هل يمكنني استخدامه لاختبار التحمّل؟
لا. فهو يرسل طلبًا واحدًا في كل مرة وعدد الطلبات محدود. استخدم أداة مخصصة لاختبار التحمّل، وفقط على الخوادم التي يُسمح لك باختبارها.
أدوات مجانية ذات صلة
تفضّل أن يصلحها أحد نيابةً عنك؟
هذه الفحوص مجانية وكذلك الأدلة. وإذا كنت تفضّل أن يُجري شخص التغييرات، يقدم فريقنا مساعدة مدفوعة.