POST AI agent ready /v1/carbon/estimate

API Perkiraan Karbon - Tampilan CO2 Per Halaman melalui Green Web Foundation

Mengambil URL dan memperkirakan emisi karbon dioksida per tampilan halaman berdasarkan byte yang ditransfer. Menggunakan metodologi Desain Web Berkelanjutan dengan faktor energi dan intensitas karbon yang dapat dikonfigurasi. Mengembalikan CO2 dalam gram, energi dalam kWh, peringkat persentil terhadap median ukuran halaman web, dan konstanta metodologi yang digunakan dalam penghitungan.

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

Pelaporan keberlanjutan situs web

Hasilkan perkiraan karbon untuk setiap halaman di situs Anda. Gabungkan hasilnya ke dalam laporan keberlanjutan yang menunjukkan perkiraan total CO2 per bulan berdasarkan volume lalu lintas Anda. Bagikan laporan tersebut kepada pemangku kepentingan atau publikasikan di situs Anda.

Lencana web hijau

Panggil titik akhir ini dan tampilkan nilai cleaner_than_percent sebagai lencana di footer situs web Anda. "Halaman ini lebih bersih dari 89% halaman web yang diuji." Mendorong optimalisasi kinerja dan membangun kepercayaan dengan pengguna yang sadar lingkungan.

Pelacakan anggaran karbon di CI

Tambahkan langkah CI yang memanggil titik akhir ini setelah membangun situs Anda. Gagalkan pembangunan jika CO2 per tampilan halaman melebihi ambang batas (misalnya, 0,5g). Lacak anggaran karbon dari waktu ke waktu beserta ukuran paket dan metrik kinerja.

Frequently asked questions

Seberapa akurat perkiraan karbon tersebut?

Perkiraan tersebut didasarkan pada ukuran transfer halaman dan metodologi Desain Web Berkelanjutan. Ini memberikan perkiraan terarah, bukan pengukuran yang tepat. Emisi sebenarnya bergantung pada perangkat pengunjung, jaringan, dan bauran energi pusat data yang melayani halaman tersebut.

Apa yang dimaksud dengan cleaner_than_percent?

Ini adalah persentase halaman web yang mentransfer byte lebih banyak daripada URL yang diuji. Skor 89 berarti halaman mentransfer byte lebih sedikit dari 89% sampel median. Lebih tinggi lebih baik.

Apakah ini memperhitungkan gambar dan skrip pihak ketiga?

Perkiraan ini didasarkan pada ukuran respons HTML awal saja. Itu tidak memuat gambar, CSS, JavaScript, atau sumber daya pihak ketiga. Untuk perkiraan satu halaman penuh, gabungkan dengan alat yang mengukur total berat halaman.

Metodologi apa yang digunakan?

Perhitungannya mengikuti Model Desain Web Berkelanjutan, yang memperkirakan energi per gigabyte yang ditransfer dan menerapkan faktor intensitas karbon rata-rata global. Konstanta metodologi disertakan dalam setiap respons untuk transparansi.

Bisakah saya menyesuaikan faktor intensitas karbon?

Tidak melalui titik akhir ini. Intensitas karbon menggunakan rata-rata global. Jika Anda mengetahui bauran energi penyedia hosting Anda, Anda dapat menerapkan faktor Anda sendiri pada nilai energy_kwh yang dikembalikan dalam respons.

Get your API key

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