Uç Noktalar
GET /api/v1/categories
Kullanılabilir tüm kategorileri ve her kategorideki birim sembollerini listeler.
| İstek | GET https://www.birimceviri.app/api/v1/categories |
GET /api/v1/convert?category=&from=&to=&value=
Belirtilen kategori içinde iki birim arasında dönüşüm yapar. Kategori ve birim sembolleri /api/v1/categories uç noktasından alınmalıdır.
| Parametre | Açıklama |
|---|---|
category | Kategori adı (ör. "uzunluk", "kutle") |
from | Kaynak birim sembolü (ör. "m") |
to | Hedef birim sembolü (ör. "km") |
value | Dönüştürülecek sayısal değer |
Örnek İstek
curl "https://www.birimceviri.app/api/v1/convert?category=uzunluk&from=m&to=km&value=5"Örnek Yanıt
{
"category": "uzunluk",
"from": "m",
"to": "km",
"value": 5,
"result": 0.005
}Hatalar
Geçersiz kategori, birim veya değer durumunda API 400 durum koduyla { "error": "..." } formatında bir yanıt döner. Dakikada 60 isteği aşan istemciler 429 alır.
CORS
Tüm uç noktalar Access-Control-Allow-Origin: * başlığıyla döner — tarayıcıdan doğrudan fetch() ile herhangi bir siteden çağırabilirsin.
Google E-Tablolar Entegrasyonu
Bu API'yi Google E-Tablolar (Sheets) içinde =BIRIMCEVIR(...) gibi özel bir formül olarak da kullanabilirsin — tablo düzenlerken hücrelerde canlı birim dönüşümü yapmak için pratik.
- Google E-Tablolar'da Uzantılar > Apps Script'i aç.
- Varsayılan kodu sil, aşağıdaki fonksiyonu yapıştırıp kaydet.
- Herhangi bir hücreye
=BIRIMCEVIR(100, "sicaklik", "C", "F")yazarak dene — ilk çalıştırmada Google yetkilendirme isteyecektir, izin ver.
function BIRIMCEVIR(deger, kategori, kaynakBirim, hedefBirim) {
var url = "https://www.birimceviri.app/api/v1/convert" +
"?category=" + encodeURIComponent(kategori) +
"&from=" + encodeURIComponent(kaynakBirim) +
"&to=" + encodeURIComponent(hedefBirim) +
"&value=" + encodeURIComponent(deger);
var response = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
var body = JSON.parse(response.getContentText());
if (response.getResponseCode() !== 200) {
throw new Error(body.error || "Dönüşüm başarısız oldu.");
}
return body.result;
}Kategori parametresi zorunludur — bazı birim sembolleri kategoriler arası çakışır (ör. F hem Fahrenheit hem Farad olabilir), bu yüzden otomatik tahmin güvenli değildir. Önbellekleme, birim listeleme fonksiyonları ve tam kurulum adımları için depodaki google-sheets-addon/ klasörüne bakabilirsin.
Canlı Dene
Kategori listesi yükleniyor…