POST AI agent ready /v1/carbon/estimate

API Carbon Estimate — CO2 на просмотр страницы через Green Web Foundation

Получает URL-адрес и оценивает выбросы углекислого газа за просмотр страницы на основе переданных байтов. Использует методологию устойчивого веб-дизайна с настраиваемыми коэффициентами энергопотребления и углеродоемкости. Возвращает CO2 в граммах, энергию в кВтч, процентильный рейтинг относительно среднего размера веб-страницы и методологические константы, использованные в расчетах.

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

Отчет об устойчивости веб-сайта

Создавайте оценки выбросов углерода для каждой страницы вашего сайта. Объедините результаты в отчет об устойчивом развитии, показывающий общий расчетный объем выбросов CO2 в месяц на основе объема вашего трафика. Поделитесь отчетом с заинтересованными сторонами или опубликуйте его на своем сайте.

Зеленые веб-значки

Вызовите эту конечную точку и отобразите значение clean_than_percent в виде значка в нижнем колонтитуле вашего веб-сайта. «Эта страница чище, чем 89% протестированных веб-страниц». Стимулирует оптимизацию производительности и укрепляет доверие со стороны экологически сознательных пользователей.

Отслеживание углеродного бюджета в CI

Добавьте шаг CI, который вызывает эту конечную точку после создания сайта. Сбой сборки, если CO2 на просмотр страницы превышает пороговое значение (например, 0,5 г). Отслеживайте баланс выбросов углерода с течением времени, а также размер пакета и показатели производительности.

Frequently asked questions

Насколько точна оценка выбросов углерода?

Оценка основана на размере передаваемой страницы и методологии устойчивого веб-дизайна. Он обеспечивает оценку направления, а не точное измерение. Фактические выбросы зависят от устройства посетителя, сети и структуры энергопотребления центра обработки данных, обслуживающего страницу.

Что означает «Чище_чем_процент»?

Это процент веб-страниц, которые передают больше байтов, чем тестируемый URL-адрес. Оценка 89 означает, что страница передает меньше байтов, чем 89% медианной выборки. Чем выше, тем лучше.

Учитываются ли при этом изображения и сторонние скрипты?

Оценка основана только на исходном размере ответа HTML. Он не загружает изображения, CSS, JavaScript или сторонние ресурсы. Для полной оценки страницы используйте инструмент, измеряющий общий вес страницы.

Какая методология используется?

Расчеты основаны на модели устойчивого веб-дизайна, которая оценивает энергию на каждый переданный гигабайт и применяет глобальный средний коэффициент интенсивности выбросов углекислого газа. Константы методологии включены в каждый ответ в целях прозрачности.

Могу ли я настроить коэффициент интенсивности выбросов углекислого газа?

Не через эту конечную точку. В качестве показателя углеродоемкости используется среднее глобальное значение. Если вы знаете структуру энергопотребления вашего хостинг-провайдера, вы можете применить свой собственный коэффициент к значению Energy_kwh, возвращаемому в ответе.

Get your API key

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