Une API de compensation carbone pour les écoles de pilotage, les aéroclubs et les flottes
Compensez chaque leçon, chaque journée de vol ou chaque plein de carburant depuis vos propres logiciels. Comment fonctionne une API de compensation carbone, ce qu’elle coûte, et quand un plan convient mieux.
8 min de lecture

Une API de compensation carbone permet à vos logiciels d’acheter eux-mêmes des compensations carbone. Votre logiciel de planification clôture une leçon, envoie une requête, et le CO₂ de ce vol est compensé, avec un certificat public à la clé. Personne ne saisit de numéro de carte ni n’exporte de tableur en fin de mois.
Cela compte dès qu’une flotte vole beaucoup. Les plans en libre-service de TrimCarbon s’arrêtent à 15 tonnes de CO₂ par an, soit environ 170 heures d’un seul Cessna 172. Un 172 d’école qui vole 600 heures par an produit à lui seul 52,8 tonnes. L’API de compensation de TrimCarbon est conçue pour cette échelle : des entreprises qui compensent leurs propres vols, au fur et à mesure.
TrimCarbon vend des compensations carbone et exploite cette API. Je suis pilote privé, titulaire des qualifications de vol de nuit et hydravion, avec 170 heures de vol, surtout en Cessna 172.
Ce que fait une API de compensation carbone
Elle réduit la compensation à une seule requête HTTP. Avec l’API de compensation de TrimCarbon, votre système :
- Achète au volume ou au prix. Envoyez
{"kg": 115}pour compenser 115 kg de CO₂, ou{"amount_cents": 50000}pour dépenser jusqu’à 500 $ en autant de kg entiers que ce montant permet d’en acheter. - Paie depuis un solde prépayé. Vous approvisionnez par carte un solde en dollars américains, à partir de 250 $, et chaque achat en est déduit. Pas de paiement par carte à chaque vol.
- Fait retirer les crédits. Nous achetons et retirons les crédits carbone par l’intermédiaire de notre fournisseur, généralement en quelques minutes. Comment les crédits sont sélectionnés.
- Reçoit une preuve. Chaque compensation reçoit un certificat public dans le registre TrimCarbon, qui liste les projets sur lesquels elle repose, leurs identifiants de registre et les numéros de série des retraits.
Votre logiciel peut aussi lire le solde, lister les compensations passées et obtenir des totaux, pour que les mêmes chiffres alimentent un tableau de bord ou un rapport de développement durable.
L’API est destinée aux entreprises qui compensent leurs propres émissions : la flotte d’une école, les avions d’un club, les vols d’un exploitant. Nous examinons chaque demande d’accès.
Quand l’API l’emporte sur un plan, et quand ce n’est pas le cas
Un plan est le choix le plus simple quand vous connaissez vos heures de vol à l’avance. Vous choisissez une quantité, et il se renouvelle tout seul. L’API convient mieux quand :
- Vos vols dépassent 15 tonnes par an. C’est le plafond des plans en libre-service : environ 170 heures d’un 172, 194 d’un PA-28 ou 258 d’un 152.
- Vos heures varient d’un mois à l’autre. Un plan facture un montant fixe. L’API compense ce que vous avez réellement volé, à partir de vos propres relevés.
- Vous voulez une compensation par vol. Chaque leçon, location ou mission reçoit sa propre compensation, étiquetée avec votre numéro de réservation.
- Vous la voulez dans vos propres outils. Un bouton dans votre outil de régulation des vols, une ligne dans votre traitement de nuit, un total sur votre site web.
Si vous volez sur votre propre avion ou louez quelques heures par mois, un plan coûte moins cher et ne demande aucun code : 0,036 $ par kg avec le plan mensuel, contre 0,04 $ au tarif standard de l’API. Voyez ce que coûte la compensation d’une heure de vol ou comparez les plans.
Cinq façons dont les écoles, les aéroclubs et les exploitants l’utilisent
1. Compenser chaque leçon à sa clôture. Un Cessna 172 brûle environ 10,6 gallons US (environ 40 L) par heure à un régime de croisière typique, soit 88 kg de CO₂. Quand l’instructeur clôture une leçon de 1,3 heure, le logiciel de planification envoie 1,3 × 88 = 114,4 kg, arrondis au kilogramme supérieur, soit 115 kg. À 0,04 $ par kg, cela fait 4,60 $. Le numéro de réservation va dans le champ reference, pour que chaque compensation puisse être rattachée à un vol.
2. Compenser les vols de la journée en un seul lot. Certaines écoles préfèrent envoyer une requête par nuit : la somme du temps Hobbs de la journée, avion par avion. Trente heures en 172 font 2 640 kg, soit 105,60 $. Une requête par jour, c’est aussi un certificat par jour, plus facile à partager que trente.
3. Compenser à partir des relevés de carburant. Le carburant embarqué est le chiffre le plus précis dont vous disposez. Chaque gallon US d’avgas produit 8,31 kg de CO₂ (le facteur d’émission de l’EPA), soit environ 2,20 kg par litre : un plein de 40 gallons (environ 151 L) représente donc 332 kg. Les exploitants d’avions à turbine peuvent faire de même avec le Jet A, à 3,15 kg de CO₂ par kg de carburant, le facteur qu’utilise notre calculateur. Les exploitants de travail aérien, de levés aériens ou de parachutisme disposent souvent déjà de ces relevés.
4. Dépenser un budget mensuel fixe. Un club qui met de côté 500 $ par mois pour la compensation envoie {"amount_cents": 50000} une fois par mois. L’API achète le plus grand nombre de kg entiers que permet le budget, et ne facture jamais plus que celui-ci.
5. Montrer le total aux membres et aux élèves. Une clé en lecture seule peut récupérer vos totaux et vos compensations récentes pour une page de votre site web ou un écran de la salle de briefing, sans pouvoir rien acheter. Chaque certificat a un lien public que vous pouvez partager.
À quoi ressemble un achat
Voici la requête complète pour la leçon de l’exemple 1. La clé Idempotency-Key permet de la renvoyer sans risque : si la connexion est coupée et que votre système l’envoie de nouveau, l’API renvoie la même compensation au lieu d’acheter deux fois. Mettez-y votre numéro de réservation, pour qu’un même vol ne puisse jamais être compensé deux fois.
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 réponse indique la quantité compensée et le montant débité. La compensation a d’abord le statut processing, puis placed une fois les crédits retirés, avec un lien vers son certificat. Le démarrage rapide (en anglais) vous guide dans votre premier achat avec une clé de test, et la référence de l’API (en anglais) donne des exemples en curl, Node, Python et PHP.
Pour commencer
- Demandez l’accès. Sur la page développeurs, présentez votre organisation et indiquez combien vous prévoyez de compenser. Votre compte doit avoir l’authentification à deux facteurs ou une clé d’accès avant que nous l’approuvions, car ses clés dépensent de l’argent réel.
- Développez avec des clés de test. Une clé de test (
tc_test_…) dépense un solde simulé de 1 000 $ que vous pouvez réinitialiser à tout moment. Les compensations de test sont passées après quelques secondes et ne retirent rien : vous pouvez donc essayer tous les cas, y compris un solde vide. - Approvisionnez. Chaque approvisionnement va de 250 $ à 10 000 $ par carte, avec une facture, et le solde peut atteindre 50 000 $. Au-delà, nous pouvons vous envoyer une facture.
- Passez à une clé réelle. Les clés réelles (
tc_live_…) dépensent votre vrai solde. Une clé peut acheter, ou seulement lire.
Ce qu’elle coûte, et les règles qui l’accompagnent
Chaque compte a son propre tarif par kg de CO₂, fixé lorsque nous l’approuvons et affiché sur votre page développeurs. Le tarif standard est de 0,04 $ par kg, soit 40 $ la tonne, comme une tonne en achat unique sur notre site web. Cela représente environ 0,33 $ par gallon US d’avgas (environ 0,09 $ par litre). Les comptes importants peuvent obtenir un tarif sur mesure : indiquez-nous votre volume lorsque vous demandez l’accès.
Quelques règles protègent votre argent :
- Le solde est prépayé et non remboursable. Il n’expire pas, ne sert qu’aux achats par l’API et est perdu si vous supprimez votre compte. Approvisionnez ce que vous prévoyez d’utiliser dans les mois qui viennent, pas une année d’un coup.
- Un solde vide bloque les achats. Un achat que le solde ne couvre pas échoue avec une erreur claire, et rien n’est acheté. Vous choisissez un seuil, et nous vous écrivons quand le solde passe en dessous.
- Les gros achats attendent un examen. Un achat de plus de 15 tonnes est payé sur le solde, puis attend notre vérification avant que les crédits soient retirés, au cas où une faute de frappe transformerait 150 kg en 150 000.
- Le coût des commandes échouées revient sur le solde. Si une commande ne peut pas être passée malgré nos nouvelles tentatives, son coût revient sur votre solde.
Avant de vous dire neutre en carbone
Compenser le CO₂ d’une flotte ne l’annule pas : cela finance le retrait de crédits carbone notés pour la même quantité, chacun censé représenter une tonne évitée ou absorbée ailleurs. Alors réduisez d’abord votre consommation, et vérifiez ce que vous pouvez dire, ou non, après avoir compensé avant de l’afficher sur votre site web.
Les certificats aident dans tous les cas. Tout le monde peut vérifier ce qu’indique un certificat, jusqu’aux numéros de série sur le registre : votre allégation repose ainsi sur des fiches de registre, pas sur notre parole.
Les questions que posent les écoles et les exploitants
Pouvons-nous compenser les vols de nos élèves et de nos locataires ? Oui. Les leçons et les locations sur vos avions font partie des émissions de votre flotte. Si vous voulez vendre des compensations à des clients pour des vols qui ne sont pas les vôtres, parlez-nous-en d’abord : l’API sert à compenser vos propres vols.
Avons-nous besoin d’un développeur ? Il faut quelqu’un capable d’envoyer une requête HTTP depuis votre logiciel de planification, un script ou un outil d’automatisation. Le démarrage rapide (en anglais) prend quelques minutes avec une clé de test. Sans personne de technique, un plan ou une estimation pour votre flotte est la voie la plus simple.
Combien de requêtes pouvons-nous envoyer ? 60 par minute et par clé, et un seul achat peut atteindre 1 000 tonnes. La plupart des flottes n’ont besoin que d’une requête par vol ou par jour.
Pouvons-nous garder un plan et utiliser l’API ? Oui. Ils sont indépendants : un plan continue de compenser sa quantité fixe, et l’API compense ce que vous envoyez. Nos pages pour les écoles de pilotage et les aéroclubs présentent les plans, et le plan climat pour les écoles et les aéroclubs explique comment financer la compensation.
Consommez d’abord moins, puis compensez ce qui reste. Calculez ce que représente votre flotte, ou demandez l’accès à l’API.
Combien émettent vos vols ?
Choisissez votre avion et vos heures pour voir le CO₂ et ce que coûte sa compensation.
Calculer mes heures