POST AI agent ready /v1/site/performance

واجهة برمجة تطبيقات أداء الموقع - TTFB وعمليات إعادة التوجيه وفحص الضغط

يجلب عنوان URL ويقيس الوقت حتى البايت الأول (TTFB)، وإجمالي وقت الاستجابة، وترميز المحتوى (gzip، أو brotli، أو لا شيء)، وعدد إعادة التوجيه، وسلسلة إعادة التوجيه مع كل قفزة، ورمز حالة HTTP، ورأس الخادم، وبيانات تعريف المحتوى. مفيد لمراقبة الأداء، وبوابات CI/CD، وتصحيح أخطاء التحميل البطيء للصفحات.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/site/performance \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

When to use this API

لوحات مراقبة وقت التشغيل

قم باستقصاء نقطة النهاية هذه كل دقيقة لعناوين URL الخاصة بالإنتاج. تتبع TTFB وtotal_time_ms مع مرور الوقت. تنبيه عندما يتجاوز TTFB حد اتفاقية مستوى الخدمة (SLA) الخاص بك أو عندما لا يكون رمز الحالة 200.

بوابات أداء CI/CD

قم باستدعاء نقطة النهاية هذه بعد النشر إلى التدريج. يفشل المسار إذا تجاوز TTFB 500 مللي ثانية أو إذا تم تعطيل الضغط. قبض على تراجعات الأداء قبل أن تصل إلى الإنتاج.

إعادة توجيه تصحيح السلسلة

مرر عنوان URL وافحص مصفوفة redirect_chain لرؤية كل قفزة ورمز الحالة والتوقيت. تحديد عمليات إعادة التوجيه غير الضرورية التي تضيف زمن الوصول. الأسباب الشائعة: عمليات إعادة توجيه HTTP-to-HTTPS، وwww-to-non-www، والشرطة المائلة اللاحقة.

Frequently asked questions

ماذا يقيس TTFB؟

الوقت حتى البايت الأول (TTFB) هو الوقت بالمللي ثانية بين إرسال طلب HTTP واستلام البايت الأول من الاستجابة. ويتضمن دقة DNS واتصال TCP ومصافحة TLS ووقت معالجة الخادم.

هل يؤدي ذلك إلى تنفيذ JavaScript أو عرض الصفحة؟

لا. تقيس نقطة النهاية هذه استجابة HTTP، وليس العرض من جانب العميل. يقوم بقياس استجابة الخادم ويفحص الرؤوس. للحصول على أداء عرض JavaScript، استخدم أداة تعتمد على المتصفح مثل Lighthouse.

من أين يتم إرسال الطلب؟

يتم إرسال الطلبات من العقد الطرفية لعمال Cloudflare. يتعامل أقرب مركز بيانات Cloudflare مع الطلب، لذلك يعكس TTFB زمن الاستجابة بين عقدة الحافة والخادم الهدف.

كم عدد عمليات إعادة التوجيه التي تتبعها؟

تتبع نقطة النهاية ما يصل إلى 10 عمليات إعادة توجيه. يتم تسجيل كل عملية إعادة توجيه في مصفوفة redirect_chain مع عنوان URL الخاص بها ورمز الحالة والتوقيت. إذا تجاوزت السلسلة 10 قفزات، فسيفشل الطلب مع حدوث خطأ في حلقة إعادة التوجيه.

هل يمكنني اختبار الصفحات المصادق عليها؟

لا. ترسل نقطة النهاية طلب GET قياسيًا بدون ملفات تعريف الارتباط أو رؤوس المصادقة. فهو يقيس أداء الصفحات التي يمكن الوصول إليها بشكل عام فقط.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.