API v1
Documentation API
Integrez le calcul d'empreinte carbone directement dans vos applications avec notre API REST simple et puissante.
Guide de demarrage
Limites de l'API
Free: 100 requetes/mois
Pro: 10 000 requetes/mois
Enterprise: Illimite
Authentification
Toutes les requetes authentifiees doivent inclure votre cle API dans le header:
Authorization: Bearer YOUR_API_KEYVous pouvez generer votre cle API dans les parametres de votre compte.
Endpoints disponibles
| Methode | Endpoint | Description | Auth |
|---|---|---|---|
| POST | /api/v1/calculate | Calculer l'empreinte carbone | |
| GET | /api/v1/calculation/:id | Recuperer un calcul existant | |
| GET | /api/v1/factors | Lister les facteurs d'emission ADEME | Public |
| GET | /api/v1/sectors | Lister les secteurs d'activite | Public |
| POST | /api/v1/report/generate | Generer un rapport PDF BEGES | |
| GET | /api/v1/benchmark/:sector | Benchmark sectoriel |
Exemples de code
const response = await fetch('https://api.scorecarbon.fr/v1/calculate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
company: {
name: 'Ma PME',
sector: 'services',
employees: 50
},
energy: {
electricity_kwh: 45000,
gas_kwh: 12000
},
transport: {
car_km: 25000,
train_km: 5000
}
})
});
const data = await response.json();
console.log(data);Format de reponse
Exemple de reponse JSON
{
"success": true,
"calculation": {
"id": "calc_abc123",
"total_emissions": 42.5,
"unit": "tCO2e",
"breakdown": {
"scope1": 8.2,
"scope2": 12.3,
"scope3": 22.0
},
"by_category": {
"energy": 12.3,
"transport": 8.2,
"purchases": 18.5,
"waste": 3.5
},
"benchmark": {
"sector_average": 55.0,
"percentile": 25,
"rating": "A"
}
}
}Pret a integrer CarbonScore ?
Creez votre compte gratuitement et obtenez votre cle API en quelques minutes.