CarbonCAM API
Karbon ayak izi hesaplama ve AI destekli makine analizi için güçlü REST API
Base URL
https://carboncam.com.tr/apiHızlı Başlangıç
CarbonCAM API ile karbon ayak izi hesaplamalarına hemen başlayın. Aşağıdaki adımları takip ederek ilk API çağrınızı yapabilirsiniz.
API Anahtarı Alın
Dashboard'dan API anahtarınızı oluşturun. Her istek için bu anahtar gereklidir.
API Anahtarı Oluşturİlk İsteğinizi Yapın
cURL veya tercih ettiğiniz HTTP client ile basit bir hesaplama yapın.
curl -X POST https://carboncam.com.tr/api/calculate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"machine_type": "CNC Freze",
"power_kw": 15,
"process_time_minutes": 60,
"material": "Çelik",
"weight_kg": 10
}'Yanıtı İşleyin
API, hesaplanan karbon emisyonu ve enerji tüketimi bilgilerini JSON formatında döndürür.
{
"success": true,
"data": {
"total_energy_kwh": 15.0,
"total_carbon_kg": 5.85,
"carbon_intensity": 0.39,
"breakdown": {
"machining_energy": 12.5,
"idle_energy": 2.5,
"material_factor": 1.2
}
}
}Kimlik Doğrulama
CarbonCAM API, Bearer token authentication kullanır. Her istekte API anahtarınızı Authorization header'ında göndermeniz gerekmektedir.
Güvenlik Uyarısı
API anahtarınızı asla client-side kodda veya public repository'lerde paylaşmayın. Sunucu tarafında güvenli bir şekilde saklayın.
Authorization: Bearer cc_live_xxxxxxxxxxxxxxxxxxxxTest Anahtarları
cc_test_ ile başlar. Geliştirme ortamında kullanılır.
Canlı Anahtarlar
cc_live_ ile başlar. Production ortamında kullanılır.
Karbon Hesaplama
Makine işleme süreçleri için karbon ayak izi hesaplaması yapın.
İstek Parametreleri
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| machine_type | string | ✓ | Makine türü (CNC Freze, Torna, vb.) |
| power_kw | number | ✓ | Makine gücü (kW) |
| process_time_minutes | number | ✓ | İşlem süresi (dakika) |
| material | string | - | İşlenen malzeme |
| weight_kg | number | - | Malzeme ağırlığı (kg) |
const response = await fetch('https://carboncam.com.tr/api/calculate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
machine_type: 'CNC Freze',
power_kw: 15,
process_time_minutes: 60,
material: 'Çelik',
weight_kg: 10
})
});
const data = await response.json();
console.log(data);AI Görüntü Analizi
Makine fotoğraflarını AI ile analiz ederek otomatik tanıma ve parametre tahmini yapın.
AI Destekli
Bu endpoint Google Gemini AI kullanarak makine fotoğraflarını analiz eder. 200+ marka ve 30+ makine kategorisi tanıyabilir.
const response = await fetch('https://carboncam.com.tr/api/analyze-image', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
image: 'data:image/jpeg;base64,/9j/4AAQSkZJRg...',
analyze_type: 'machine'
})
});
const result = await response.json();
// {
// machine_type: "CNC Milling Machine",
// brand: "DMG MORI",
// model: "DMU 50",
// estimated_power_kw: 25,
// confidence: 0.92
// }Hata Kodları
API standart HTTP durum kodları kullanır. Aşağıda sık karşılaşılan hatalar listelenmiştir.
Bad Request
İstek parametreleri geçersiz veya eksik.
Unauthorized
API anahtarı eksik veya geçersiz.
Forbidden
Bu kaynağa erişim izniniz yok.
Rate Limited
Çok fazla istek gönderildi. Lütfen bekleyin.
Internal Server Error
Sunucu hatası. Lütfen daha sonra tekrar deneyin.
{
"success": false,
"error": {
"code": "INVALID_PARAMETER",
"message": "power_kw must be a positive number",
"details": {
"field": "power_kw",
"received": -5
}
}
}SDK & Kütüphaneler
Popüler programlama dilleri için resmi SDK'larımız yakında yayınlanacak.
Yardıma mı ihtiyacınız var?
Sorularınız için destek ekibimizle iletişime geçebilirsiniz.