API anahtarı veya kayıt gerekmez. Tüm uç noktalar salt-okunuz (GET)'tur — kayıt sorgulama, skor okuma, sektör/benchmark verisi çekme dahil. Yazma yönü yalnız iki noktada vardır: profil sahiplenme (claim) ve itiraz açma; bu ikisi kurumsal e-posta doğrulaması ister (bkz. Gizlilik).
API'den çektiğiniz veriyi yeniden yayınlarken veya bir üründe kullanırken kaynağı "Carbonbench" olarak belirtin ve mümkünse ilgili kayda bağlantı verin. Detay: Kullanım Şartları.
Makul istek sıklığında kalın. Tüm evreni tekrar tekrar, kısa aralıklarla toplu çekmek yerine sayfalama (limit/offset) parametrelerini kullanın ve sonucu kendi tarafınızda önbelleğe alın. Adil kullanımı aşan veya sunucuyu zorlayan erişim, önceden bildirim yapılmaksızın sınırlanabilir veya engellenebilir.
API, ürünün geri kalanıyla aynı "olduğu gibi" ilkesine tabidir — kesintisizlik veya geriye dönük uyumluluk garantisi verilmez. Skorlama formülleri yılda iki pencerede (Ocak/Temmuz) güncellenir; alan adları ve uç nokta şekilleri de zamanla değişebilir. Kritik entegrasyonlarda sürüm/tarih bilgisini (kayıtların version alanı) kontrol edin.
curl https://carbonbench.org/api/records/{id}.json
Yayında (production) host adresi değişecektir; yerel geliştirme sunucusu için adres budur. {id} yerine bir record_id değeri geçirin — Evren tablosundaki bir satıra tıklayınca URL'de görünür.
The Carbonbench API is free, read-only, and requires no key (interactive docs at /docs). Reuse requires attribution ("Carbonbench" + link). Fair use applies: no aggressive scraping — use pagination and cache results client-side. The API is provided as-is with no uptime or backward-compatibility guarantee; scoring formulas update on two fixed windows per year (January/July). Example request: curl https://carbonbench.org/api/records/{id}.json.