POST AI agent ready /v1/carbon/estimate

واجهة برمجة تطبيقات تقدير الكربون - عرض ثاني أكسيد الكربون لكل صفحة عبر Green Web Foundation

جلب عنوان URL وتقدير انبعاثات ثاني أكسيد الكربون لكل عرض للصفحة بناءً على البايتات المنقولة. يستخدم منهجية تصميم الويب المستدام مع عوامل الطاقة وكثافة الكربون القابلة للتكوين. تُرجع ثاني أكسيد الكربون بالجرام، والطاقة بالكيلوواط ساعة، وترتيب مئوي مقابل متوسط حجم صفحة الويب، وثوابت المنهجية المستخدمة في الحساب.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/carbon/estimate \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.wikipedia.org"}'

When to use this API

تقارير استدامة الموقع

قم بإنشاء تقديرات الكربون لكل صفحة على موقعك. قم بتجميع النتائج في تقرير استدامة يوضح إجمالي ثاني أكسيد الكربون المقدر شهريًا بناءً على حجم حركة المرور الخاصة بك. شارك التقرير مع أصحاب المصلحة أو انشره على موقعك.

شارات الويب الخضراء

اتصل بنقطة النهاية هذه واعرض قيمة Cleaner_than_percent كشارة على تذييل موقع الويب الخاص بك. "هذه الصفحة أنظف من 89% من صفحات الويب التي تم اختبارها." يشجع على تحسين الأداء ويبني الثقة مع المستخدمين المهتمين بالبيئة.

تتبع ميزانية الكربون في CI

أضف خطوة CI التي تستدعي نقطة النهاية هذه بعد إنشاء موقعك. فشل الإنشاء إذا تجاوز ثاني أكسيد الكربون لكل عرض صفحة الحد الأدنى (على سبيل المثال، 0.5 جم). تتبع ميزانية الكربون بمرور الوقت جنبًا إلى جنب مع حجم الحزمة ومقاييس الأداء.

Frequently asked questions

ما مدى دقة تقدير الكربون؟

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

ماذا يعني clean_than_percent؟

هذه هي النسبة المئوية لصفحات الويب التي تنقل وحدات بايت أكثر من عنوان URL الذي تم اختباره. تعني الدرجة 89 أن الصفحة تنقل بايتات أقل من 89% من العينة المتوسطة. الأعلى هو الأفضل.

هل يأخذ هذا في الاعتبار الصور والبرامج النصية التابعة لجهات خارجية؟

يعتمد التقدير على حجم استجابة HTML الأولي فقط. ولا يقوم بتحميل الصور أو CSS أو JavaScript أو موارد الطرف الثالث. للحصول على تقدير للصفحة الكاملة، قم بدمجه مع أداة تقيس إجمالي وزن الصفحة.

ما هي المنهجية المستخدمة؟

يتبع الحساب نموذج تصميم الويب المستدام، الذي يقدر الطاقة لكل جيجابايت منقولة ويطبق متوسط عامل كثافة الكربون العالمي. يتم تضمين ثوابت المنهجية في كل استجابة من أجل الشفافية.

هل يمكنني تخصيص عامل كثافة الكربون؟

ليس من خلال نقطة النهاية هذه. تستخدم كثافة الكربون المتوسط العالمي. إذا كنت تعرف مزيج الطاقة الخاص بمزود الاستضافة، فيمكنك تطبيق العامل الخاص بك على قيمة power_kwh التي تم إرجاعها في الاستجابة.

Get your API key

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