Un’API di compensazione della CO₂ per scuole di volo, aeroclub e flotte

Un’API di compensazione della CO₂ permette al suo software di acquistare compensazioni in autonomia. Il suo sistema di prenotazione chiude una lezione, invia una richiesta e la CO₂ di quel volo è compensata, con un certificato pubblico a dimostrarlo. Nessuno deve digitare numeri di carta o esportare fogli di calcolo a fine mese.

Questo conta quando una flotta vola molto. I piani online di TrimCarbon arrivano fino a 15 tonnellate di CO₂ all’anno, circa 170 ore di un solo Cessna 172. Un 172 di una scuola che vola 600 ore all’anno ne produce da solo 52,8 tonnellate. L’API di compensazione di TrimCarbon è pensata per questa scala: imprese che compensano i propri voli man mano che li effettuano.

TrimCarbon vende compensazioni delle emissioni di CO₂ e gestisce questa API. Io sono un pilota privato con le abilitazioni al volo notturno e all’idrovolante e 170 ore di volo, quasi tutte su Cessna 172.

Cosa fa un’API di compensazione della CO₂

Trasforma la compensazione in una sola richiesta HTTP. Con l’API di compensazione di TrimCarbon, il suo sistema:

1. Acquista a quantità o a importo. Invii {"kg": 115} per compensare 115 kg di CO₂, oppure {"amount_cents": 50000} per spendere fino a 500 USD in tutti i kg interi che quell’importo consente.
2. Paga da un saldo prepagato. Lei ricarica un saldo in USD con carta, a partire da 250 USD, e ogni acquisto viene scalato dal saldo. Nessun addebito sulla carta per ogni volo.
3. Ottiene il ritiro dei crediti. Acquistiamo e ritiriamo i crediti di carbonio tramite il nostro fornitore, di solito in pochi minuti. Come vengono verificati i crediti.
4. Ottiene una prova. Ogni compensazione riceve un certificato pubblico nel registro di TrimCarbon, con i progetti che la sostengono, i loro ID nel registro e i numeri di serie del ritiro.

Il suo software può anche leggere il saldo, elencare le compensazioni passate e ottenere i totali, così gli stessi numeri possono alimentare un pannello di monitoraggio o un bilancio di sostenibilità.

L’API è per le imprese che compensano le proprie emissioni: la flotta di una scuola, gli aerei di un aeroclub, i voli di un operatore. Esaminiamo ogni richiesta di accesso.

Quando l’API conviene più di un piano, e quando no

Un piano è la scelta più semplice quando conosce in anticipo quanto volerà. Sceglie una quantità e il piano si rinnova da solo. L’API è più adatta quando:

• I suoi voli superano le 15 tonnellate all’anno. È il tetto dei piani online: circa 170 ore di un 172, 172 di un PA-28 o 294 di un 152.
• Le sue ore cambiano da un mese all’altro. Un piano addebita un importo fisso. L’API compensa quello che ha effettivamente volato, in base ai suoi registri.
• Vuole una compensazione per ogni volo. Ogni lezione, noleggio o lavoro ha la sua compensazione, contrassegnata con il suo numero di prenotazione.
• La vuole nei suoi strumenti. Un pulsante nella sua schermata di dispatch, una riga nel suo processo notturno, un totale sul suo sito web.

Se vola con il suo aereo o noleggia poche ore al mese, un piano costa meno e non richiede codice: 0,036 USD al kg con il piano mensile, contro la tariffa standard dell’API di 0,04 USD. Veda quanto costa compensare un’ora di volo o confronti i piani.

Cinque modi in cui scuole, aeroclub e operatori la usano

1. Compensi ogni lezione alla chiusura. Un Cessna 172 consuma circa 10,6 galloni USA (40 litri) all’ora a un regime di crociera tipico, ossia 88 kg di CO₂. Quando l’istruttore chiude una lezione di 1,3 ore, il sistema di prenotazione invia 1,3 × 88 = 114,4 kg, arrotondati per eccesso a 115 kg. A 0,04 USD al kg, sono 4,60 USD. Il numero di prenotazione va nel campo reference, così ogni compensazione è riconducibile a un volo.

2. Compensi i voli della giornata in un solo invio. Alcune scuole preferiscono inviare una richiesta per notte: la somma del tempo Hobbs della giornata, aereo per aereo. Trenta ore su 172 fanno 2640 kg, ossia 105,60 USD. Una richiesta al giorno significa anche un certificato al giorno, più facile da condividere di trenta.

3. Compensi in base ai registri del carburante. Il carburante rifornito è il dato più preciso che ha. Ogni gallone USA di avgas produce 8,31 kg di CO₂ (il fattore di emissione dell’EPA, l’agenzia per la protezione dell’ambiente degli Stati Uniti), ossia 2,20 kg per litro, quindi un rifornimento di 40 galloni (151 litri) corrisponde a 332 kg. Gli operatori di aerei a turbina possono fare lo stesso con il Jet A, a 3,15 kg di CO₂ per kg di carburante, il fattore che usa il nostro calcolatore. Gli operatori di lavoro aereo, rilevamento aereo e paracadutismo spesso hanno già questi registri.

4. Spenda un budget mensile fisso. Un aeroclub che accantona 500 USD al mese per la compensazione invia {"amount_cents": 50000} una volta al mese. L’API acquista il maggior numero di kg interi che rientrano nel budget, e non addebita mai più di quella cifra.

5. Mostri il totale a soci e allievi. Una chiave di sola lettura può recuperare i suoi totali e le compensazioni recenti per una pagina del suo sito web o uno schermo nella sala briefing, senza poter acquistare nulla. Ogni certificato ha un link pubblico che può condividere.

Com’è fatto un acquisto

Questa è la richiesta completa per la lezione dell’esempio 1. L’intestazione Idempotency-Key permette di riprovare senza rischi: se la rete cade e il suo sistema invia di nuovo la richiesta, l’API restituisce la stessa compensazione invece di acquistare due volte. Ci inserisca il suo numero di prenotazione, così un volo non potrà mai essere compensato due volte.

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"}'

La risposta indica quanto è stato compensato e addebitato. All’inizio la compensazione è processing, poi diventa placed quando i crediti sono ritirati, con un link al suo certificato. La guida rapida la accompagna passo per passo nel primo acquisto con una chiave di test, e il riferimento dell’API (in inglese) contiene esempi in curl, Node, Python e PHP.

Come iniziare

1. Richieda l’accesso. Nella pagina Sviluppatori, ci parli della sua organizzazione e di quanto prevede di compensare. Prima che lo approviamo, il suo account deve avere l’autenticazione a due fattori o una passkey, perché le sue chiavi spendono denaro reale.
2. Sviluppi con le chiavi di test. Una chiave di test (tc_test_…) spende un saldo simulato di 1000 USD che può ripristinare in qualsiasi momento. Le compensazioni di test risultano completate dopo pochi secondi e non ritirano nulla, quindi può provare ogni caso, compreso un saldo vuoto.
3. Ricarichi. Ogni ricarica va da 250 USD a 10.000 USD con carta, con fattura, e il saldo può arrivare a 50.000 USD. Per importi maggiori, possiamo emetterle una fattura.
4. Passi a una chiave reale. Le chiavi reali (tc_live_…) spendono il suo saldo reale. Una chiave può acquistare, oppure solo leggere.

Quanto costa, e le regole che lo accompagnano

Ogni account ha la propria tariffa per kg di CO₂, fissata quando lo approviamo e indicata nella sua pagina Sviluppatori. La tariffa standard è di 0,04 USD al kg, 40 USD la tonnellata, come una tonnellata con acquisto singolo sul nostro sito. Equivale a circa 33 centesimi di dollaro per gallone di avgas. Gli account con grandi volumi possono ottenere una tariffa personalizzata: ci indichi i suoi volumi quando richiede l’accesso.

Alcune regole proteggono il denaro:

• Il saldo è prepagato e non rimborsabile. Non scade, paga solo gli acquisti tramite l’API e va perso se elimina il suo account. Ricarichi quanto prevede di usare nei prossimi mesi, non un anno alla volta.
• Un saldo vuoto blocca gli acquisti. Un acquisto che il saldo non copre fallisce con un errore chiaro, e non viene acquistato nulla. Lei sceglie una soglia, e le inviamo un’email quando il saldo scende sotto quella soglia.
• Gli acquisti grandi attendono una verifica. Un acquisto superiore a 15 tonnellate viene pagato dal saldo, poi attende un nostro controllo prima del ritiro dei crediti, nel caso in cui un errore di battitura trasformi 150 kg in 150.000.
• Gli ordini non riusciti vengono riaccreditati. Se un ordine non va a buon fine nemmeno dopo i nostri nuovi tentativi, il suo costo torna sul suo saldo.

Prima di dire a qualcuno che è “carbon neutral”

Compensare la CO₂ di una flotta non la cancella: finanzia il ritiro di crediti di carbonio valutati da agenzie per la stessa quantità, e ciascuno di questi crediti dovrebbe rappresentare una tonnellata evitata o rimossa altrove. Quindi riduca prima il consumo di carburante, e verifichi cosa può e non può dichiarare dopo la compensazione prima di scriverlo sul suo sito.

I certificati aiutano in ogni caso. Chiunque può verificare cosa mostra un certificato, fino ai numeri di serie nel registro, quindi la sua dichiarazione si basa su dati registrati, non sulla nostra parola.

Le domande di scuole e operatori

Possiamo compensare i voli dei nostri allievi e di chi noleggia i nostri aerei? Sì. Lezioni e noleggi sui vostri aerei sono emissioni della vostra flotta. Se volete vendere compensazioni ai clienti per voli che non sono vostri, parlatene prima con noi: l’API serve a compensare i propri voli.

Ci serve uno sviluppatore? Qualcuno che sappia inviare una richiesta HTTP dal vostro sistema di prenotazione, da uno script o da uno strumento di automazione. La guida rapida richiede pochi minuti con una chiave di test. Senza nessuno con competenze tecniche, un piano o una stima per la flotta è la strada più semplice.

Quante richieste possiamo inviare? 60 al minuto per chiave, e un singolo acquisto può arrivare a 1000 tonnellate. Alla maggior parte delle flotte basta una richiesta per volo o una al giorno.

Possiamo mantenere un piano e usare l’API? Sì. Sono separati: un piano continua a compensare la sua quantità fissa, e l’API compensa quello che inviate. Le nostre pagine per scuole di volo e aeroclub trattano i piani, e la guida per scuole e aeroclub spiega come finanziare la compensazione.

Prima consumi meno, poi compensi quello che resta. Veda quanto emette in totale la sua flotta oppure richieda l’accesso all’API.