POST AI agent ready /v1/carbon/estimate

API de estimativa de carbono - visualização de CO2 por página via Green Web Foundation

Busca um URL e estima as emissões de dióxido de carbono por visualização de página com base nos bytes transferidos. Utiliza a metodologia Sustainable Web Design com fatores configuráveis de intensidade de energia e carbono. Retorna CO2 em gramas, energia em kWh, uma classificação percentual em relação ao tamanho médio da página da web e as constantes da metodologia usadas no cálculo.

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

Relatórios de sustentabilidade do site

Gere estimativas de carbono para cada página do seu site. Agregue os resultados em um relatório de sustentabilidade mostrando o total estimado de CO2 por mês com base no seu volume de tráfego. Compartilhe o relatório com as partes interessadas ou publique-o em seu site.

Emblemas verdes da web

Chame esse endpoint e exiba o valor Cleaner_than_percent como um emblema no rodapé do seu site. "Esta página é mais limpa que 89% das páginas da web testadas." Incentiva a otimização do desempenho e constrói a confiança de usuários ambientalmente conscientes.

Acompanhamento do orçamento de carbono em CI

Adicione uma etapa de CI que chame esse endpoint após criar seu site. Falha na construção se o CO2 por visualização de página exceder um limite (por exemplo, 0,5g). Acompanhe o orçamento de carbono ao longo do tempo juntamente com o tamanho do pacote e as métricas de desempenho.

Frequently asked questions

Quão precisa é a estimativa de carbono?

A estimativa é baseada no tamanho de transferência da página e na metodologia Sustainable Web Design. Ele fornece uma estimativa direcional, não uma medição precisa. As emissões reais dependem do dispositivo do visitante, da rede e do mix energético do data center que atende a página.

O que significa mais limpo que por cento?

Esta é a porcentagem de páginas da web que transferem mais bytes do que o URL testado. Uma pontuação de 89 significa que a página transfere menos bytes do que 89% da amostra média. Quanto maior, melhor.

Isso leva em conta imagens e scripts de terceiros?

A estimativa é baseada apenas no tamanho inicial da resposta HTML. Não carrega imagens, CSS, JavaScript ou recursos de terceiros. Para uma estimativa de página inteira, combine com uma ferramenta que meça o peso total da página.

Qual metodologia é usada?

O cálculo segue o Modelo de Web Design Sustentável, que estima a energia por gigabyte transferido e aplica um fator médio global de intensidade de carbono. As constantes da metodologia são incluídas em todas as respostas para fins de transparência.

Posso personalizar o fator de intensidade de carbono?

Não através deste endpoint. A intensidade de carbono utiliza uma média global. Se você conhece o mix energético do seu provedor de hospedagem, poderá aplicar seu próprio fator ao valor energy_kwh retornado na resposta.

Get your API key

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