Aller au contenu
POST AI agent ready /v1/carbon/estimate

API d'estimation du carbone - CO2 par page vue via Green Web Foundation

Récupère une URL et estime les émissions de dioxyde de carbone par page vue en fonction des octets transférés. Utilise la méthodologie de conception Web durable avec des facteurs d'intensité énergétique et carbone configurables. Renvoie le CO2 en grammes, l'énergie en kWh, un classement centile par rapport à la taille médiane de la page Web et les constantes méthodologiques utilisées dans le calcul.

Parameters

stringrequired

URL to estimate carbon emissions for.

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

Rapport sur la durabilité du site Web

Générez des estimations carbone pour chaque page de votre site. Regroupez les résultats dans un rapport de développement durable indiquant le CO2 total estimé par mois en fonction de votre volume de trafic. Partagez le rapport avec les parties prenantes ou publiez-le sur votre site.

Badges web verts

Appelez ce point de terminaison et affichez la valeur Cleaner_than_percent sous forme de badge sur le pied de page de votre site Web. "Cette page est plus propre que 89 % des pages Web testées." Encourage l'optimisation des performances et renforce la confiance avec les utilisateurs soucieux de l'environnement.

Suivi du budget carbone en CI

Ajoutez une étape CI qui appelle ce point de terminaison après la création de votre site. Échec de la construction si le CO2 par page vue dépasse un seuil (par exemple, 0,5 g). Suivez le budget carbone au fil du temps ainsi que les mesures de taille et de performances du bundle.

Frequently asked questions

Quelle est la précision de l’estimation du carbone ?
L'estimation est basée sur la taille du transfert de page et la méthodologie Sustainable Web Design. Il fournit une estimation directionnelle, pas une mesure précise. Les émissions réelles dépendent de l'appareil du visiteur, du réseau et du mix énergétique du centre de données desservant la page.
Que signifie plus propre_than_percent ?
Il s'agit du pourcentage de pages Web qui transfèrent plus d'octets que l'URL testée. Un score de 89 signifie que la page transfère moins d'octets que 89 % de l'échantillon médian. Plus haut, c'est mieux.
Cela prend-il en compte les images et les scripts tiers ?
L'estimation est basée uniquement sur la taille initiale de la réponse HTML. Il ne charge pas d'images, CSS, JavaScript ou ressources tierces. Pour une estimation d’une page complète, combinez-la avec un outil qui mesure le poids total de la page.
Quelle méthodologie est utilisée ?
Le calcul suit le modèle de conception Web durable, qui estime l'énergie par gigaoctet transféré et applique un facteur d'intensité carbone moyen mondial. Les constantes méthodologiques sont incluses dans chaque réponse par souci de transparence.
Puis-je personnaliser le facteur d’intensité carbone ?
Pas via ce point de terminaison. L’intensité carbone utilise une moyenne mondiale. Si vous connaissez le mix énergétique de votre hébergeur, vous pouvez appliquer votre propre facteur à la valeur energy_kwh renvoyée dans la réponse.

Get your API key

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

Sign up free View full docs