Uma API de compensação de carbono para escolas de aviação, aeroclubes e frotas
Compense cada aula, cada dia de voo ou cada abastecimento a partir do seu próprio software. Como funciona uma API de compensação de carbono, quanto custa e quando um plano é mais adequado.
8 min de leitura

Uma API de compensação de carbono permite que o seu software compre compensações de carbono sozinho. O seu sistema de agendamento fecha uma aula, envia uma requisição, e o CO₂ desse voo é compensado, com um certificado público como comprovação. Ninguém digita números de cartão nem exporta planilhas no fim do mês.
Isso faz diferença quando uma frota tem muito movimento. Os planos online da TrimCarbon vão até 15 toneladas de CO₂ por ano, cerca de 170 horas de um único Cessna 172. Um 172 de escola que voa 600 horas por ano emite sozinho 52,8 toneladas. A API de compensação da TrimCarbon foi feita para essa escala: empresas que compensam os próprios voos à medida que eles acontecem.
A TrimCarbon vende compensações de carbono e opera esta API, e eu sou piloto privado, com habilitação para voos noturnos e para hidroavião e 170 horas de voo, a maioria em Cessna 172.
O que faz uma API de compensação de carbono
Ela transforma a compensação em uma única requisição HTTP. Com a API de compensação da TrimCarbon, o seu sistema:
- Compra por volume ou por preço. Envie
{"kg": 115}para compensar 115 kg de CO₂, ou{"amount_cents": 50000}para gastar até US$ 500 em tantos kg inteiros quantos esse valor comprar. - Paga com um saldo pré-pago. Você recarrega um saldo em USD com cartão, a partir de US$ 250, e cada compra é descontada dele. Nenhuma cobrança no cartão a cada voo.
- Aciona a aposentadoria dos créditos. Compramos e aposentamos os créditos de carbono por meio do nosso fornecedor, geralmente em poucos minutos. Como os créditos são avaliados.
- Recebe a comprovação. Cada compensação recebe um certificado público no registro da TrimCarbon, que lista os projetos por trás dela, os seus IDs no registro e os números de série das aposentadorias.
O seu software também pode consultar o saldo, listar as compensações anteriores e obter totais, para que os mesmos números alimentem um painel ou um relatório de sustentabilidade.
A API é para empresas que compensam as próprias emissões: a frota de uma escola, as aeronaves de um aeroclube, os voos de um operador. Analisamos cada solicitação de acesso.
Quando a API é preferível a um plano, e quando não é
Um plano é a escolha mais simples quando você conhece os seus voos com antecedência. Você escolhe uma quantidade, e ele se renova sozinho. A API é mais adequada quando:
- Os seus voos passam de 15 toneladas por ano. Esse é o teto dos planos online: cerca de 170 horas de um 172, 194 de um PA-28 ou 258 de um 152.
- As suas horas mudam de um mês para o outro. Um plano cobra uma quantidade fixa. A API compensa o que você realmente voou, a partir dos seus próprios registros.
- Você quer uma compensação por voo. Cada aula, aluguel ou serviço recebe a sua própria compensação, identificada pelo seu número de reserva.
- Você quer isso nas suas próprias ferramentas. Um botão na sua tela de despacho, uma linha na sua tarefa noturna, um total no seu site.
Se você voa a sua própria aeronave ou aluga algumas horas por mês, um plano custa menos e não exige código: US$ 0,036 por kg no plano mensal, contra os US$ 0,04 padrão da API. Veja quanto custa compensar uma hora ou compare os planos.
Cinco formas de uso em escolas, aeroclubes e operadores
1. Compense cada aula quando ela é fechada. Um Cessna 172 queima cerca de 10,6 galões americanos (40 litros) por hora em um regime típico de cruzeiro, ou 88 kg de CO₂. Quando o instrutor fecha uma aula de 1,3 hora, o sistema de agendamento envia 1,3 × 88 = 114,4 kg, arredondados para cima: 115 kg. A US$ 0,04 por kg, isso dá US$ 4,60. O número da reserva vai no campo reference, para que cada compensação possa ser rastreada até um voo.
2. Compense os voos do dia em um só lote. Algumas escolas preferem enviar uma requisição por noite: a soma do tempo Hobbs do dia, aeronave por aeronave. Trinta horas em 172 são 2.640 kg, ou US$ 105,60. Uma requisição por dia também significa um certificado por dia, que é mais fácil de compartilhar do que trinta.
3. Compense a partir dos registros de combustível. O combustível abastecido é o número mais preciso que você tem. Cada galão americano de avgas gera 8,31 kg de CO₂ (o fator de emissão da EPA, a agência ambiental dos EUA), ou 2,20 kg por litro, então um abastecimento de 40 galões (151 litros) dá 332 kg. Quem opera aeronaves a turbina pode fazer o mesmo com Jet A, a 3,15 kg de CO₂ por kg de combustível, o fator que a nossa calculadora usa. Operadores de trabalho aéreo, aerolevantamento e paraquedismo muitas vezes já têm esses registros.
4. Gaste um orçamento mensal fixo. Um aeroclube que reserva US$ 500 por mês para compensação envia {"amount_cents": 50000} uma vez por mês. A API compra o maior número de kg inteiros que cabem no orçamento, e nunca cobra mais do que ele.
5. Mostre o total a sócios e alunos. Uma chave só de leitura pode buscar os seus totais e as compensações recentes para uma página no seu site ou uma tela na sala de briefing, sem poder comprar nada. Cada certificado tem um link público que você pode compartilhar.
Como é uma compra
Esta é a requisição completa para a aula do exemplo 1. A Idempotency-Key torna seguro tentar de novo: se a rede cair e o seu sistema enviar a requisição outra vez, a API devolve a mesma compensação em vez de comprar duas vezes. Use o seu número de reserva nela, para que um voo nunca possa ser compensado duas vezes.
curl https://trimcarbon.com/api/v1/offsets \
-H "Authorization: Bearer $TRIMCARBON_KEY" \
-H "Idempotency-Key: booking-48213" \
-H "Content-Type: application/json" \
-d '{"kg": 115, "reference": "Booking 48213, C-GABC"}'A resposta informa quanto foi compensado e cobrado. A compensação fica primeiro como processing e depois como placed, quando os créditos são aposentados, com um link para o certificado dela. O início rápido (em inglês) mostra passo a passo a sua primeira compra com uma chave de teste, e a referência da API (em inglês) traz exemplos em curl, Node, Python e PHP.
Como começar
- Solicite acesso. Na página de desenvolvedores, conte-nos sobre a sua organização e quanto você prevê compensar. A sua conta precisa de autenticação de dois fatores ou de uma chave de acesso antes de a aprovarmos, porque as chaves de API dela gastam dinheiro de verdade.
- Desenvolva com chaves de teste. Uma chave de teste (
tc_test_…) gasta um saldo simulado de US$ 1.000 que você pode redefinir a qualquer momento. As compensações de teste aparecem como feitas após alguns segundos e não aposentam nada, então você pode testar todos os casos, inclusive um saldo vazio. - Adicione saldo. Cada recarga vai de US$ 250 a US$ 10.000, com cartão e com fatura, e o saldo pode chegar a US$ 50.000. Para valores maiores, podemos emitir uma fatura para você.
- Mude para uma chave real. As chaves reais (
tc_live_…) gastam o seu saldo real. Uma chave pode comprar, ou só ler.
Quanto custa, e as regras que vêm junto
Cada conta tem a sua própria tarifa por kg de CO₂, definida quando a aprovamos e exibida na sua página de desenvolvedores. A tarifa padrão é de US$ 0,04 por kg, US$ 40 a tonelada, o mesmo preço de uma tonelada avulsa no nosso site. Isso dá cerca de 33 centavos de dólar por galão de avgas. Contas grandes podem obter uma tarifa sob medida: informe o seu volume quando solicitar acesso.
Algumas regras mantêm o dinheiro em segurança:
- O saldo é pré-pago e não reembolsável. Ele não expira, só paga compras pela API e é perdido se você excluir a sua conta. Recarregue o que você prevê usar nos próximos meses, e não um ano de uma vez.
- Um saldo vazio interrompe as compras. Uma compra que o saldo não cobre falha com um erro claro, e nada é comprado. Você escolhe um limite, e enviamos um e-mail quando o saldo fica abaixo dele.
- Compras grandes aguardam análise. Uma compra acima de 15 toneladas é paga com o saldo e depois aguarda a nossa verificação antes que os créditos sejam aposentados, caso um erro de digitação transforme 150 kg em 150.000.
- Pedidos que falham voltam ao saldo. Se um pedido não puder ser feito depois das nossas novas tentativas, o custo dele volta para o seu saldo.
Antes de dizer a alguém que você é carbono neutro
Compensar o CO₂ de uma frota não o desfaz: financia a aposentadoria de créditos de carbono avaliados na mesma quantidade, cada um destinado a representar uma tonelada evitada ou removida em outro lugar. Por isso, reduza o seu consumo primeiro e confira o que você pode e o que não pode dizer depois de compensar antes de colocar isso no seu site.
Os certificados ajudam de qualquer forma. Qualquer pessoa pode conferir o que um certificado mostra, até os números de série no registro, então a sua alegação se apoia em registros, e não na nossa palavra.
Perguntas que escolas e operadores fazem
Podemos compensar os voos dos nossos alunos e de quem aluga as nossas aeronaves? Sim. As aulas e os aluguéis nas suas aeronaves são emissões da sua frota. Se você quiser vender compensações a clientes por voos que não são seus, fale conosco antes: a API é para compensar os seus próprios voos.
Precisamos de um desenvolvedor? De alguém que consiga enviar uma requisição HTTP a partir do seu sistema de agendamento, de um script ou de uma ferramenta de automação. O início rápido (em inglês) leva alguns minutos com uma chave de teste. Sem ninguém da área técnica, um plano ou uma estimativa para a frota é o caminho mais fácil.
Quantas requisições podemos enviar? 60 por minuto por chave, e uma única compra pode chegar a 1.000 toneladas. A maioria das frotas precisa de uma requisição por voo ou de uma por dia.
Podemos manter um plano e usar a API? Sim. Eles são independentes: um plano continua compensando a sua quantidade fixa, e a API compensa o que você envia. As nossas páginas para escolas de aviação e aeroclubes tratam dos planos, e o guia para escolas e aeroclubes explica como financiar a compensação.
Primeiro queime menos, depois compense o que sobra. Veja quanto soma a sua frota, ou solicite acesso à API.
Quanto o seu voo emite?
Escolha sua aeronave e suas horas para ver o CO₂ e quanto custa compensá-lo.
Calcular minhas horas