Geliştiriciler İçin Ücretsiz JSON API

Ratias, geliştiriciler için ücretsiz ve açık erişimli bir matematiksel API sunar. Geliştiriciler, 13 adet yerelleştirilmiş yüzde formülünden oluşan kataloğumuza programlı olarak erişebilir veya yüksek performanslı uç noktalarımız aracılığıyla doğrudan gerçek zamanlı hesaplamalar yapabilirler.

Postman Koleksiyonu

Anında test etmeye başlamak için 13 matematiksel yüzde hesaplama uç noktasının tamamını içeren hazır Postman Koleksiyonumuzu indirin.

Koleksiyonu İndir

1. Formül Meta Veri API'si

13 matematiksel formülün tamamı için şemaları, parametreleri ve yerelleştirilmiş açıklamaları çekin:

GET https://www.ratias.com/api/formulas.json

Yanıt Yapısı Örneği

{
  "api_version": "1.1",
  "total_formulas": 13,
  "formulas": [
    {
      "id": "formula1",
      "slugs": { "en": "percentage-calculator", "tr": "yuzde-hesaplama", "de": "prozentrechner", "fr": "calculateur-pourcentage" },
      "math_formula": "Result = (A * B) / 100",
      "description": { "en": "Calculates B percent of A.", "tr": "A sayısının yüzde B'sini hesaplar.", "de": "Berechnet B Prozent von A.", "fr": "Calcule B pour cent de A." },
      "parameters": { ... }
    }
  ]
}

2. Gerçek Zamanlı Hesaplama API'si

Hesaplama API'sine sorgu parametreleri göndererek matematiksel değerleri dinamik olarak hesaplayın. Yanıt; sayısal sonucu, matematiksel formülü ve seçilen dilde dilbilgisi kurallarına uygun açıklama metnini döndürür.

GET https://www.ratias.com/api/calculate

Sorgu Parametreleri

API Sorgu Parametreleri Açıklaması
Parametre	Tür	Zorunlu	Açıklama
`formula`	Metin / Sayı	Evet	Formül tanımlayıcısı (örn. `1`, `formula1` ile `13` arası).
`val1`	Sayı	Evet	Birinci parametre değeri (Temel sayı, satış fiyatı vb.).
`val2`	Sayı	Evet	İkinci parametre değeri (Yüzde oranı, maliyet vb.). Bazı formüllerde zorunlu değildir.
`val3`	Sayı	Hayır	Üçüncü parametre değeri (Formül 8, 10 ve 13 için zorunludur).
`val4`	Sayı	Hayır	Dördüncü parametre değeri (Formül 13 için zorunludur).
`lang`	Metin	Hayır	Çıktı dili: `en`, `tr`, `de`, `fr` (varsayılan: `en`).

Örnek İstek

GET https://www.ratias.com/api/calculate?formula=1&val1=150&val2=20&lang=tr

Örnek Yanıt

{
  "success": true,
  "formula": "formula1",
  "lang": "tr",
  "inputs": {
    "val1": 150,
    "val2": 20
  },
  "data": {
    "result": 30,
    "text": "150'nin %20'si 30'dur",
    "formula": "(150 × 20) ÷ 100 = 30"
  }
}

3. Entegrasyon Kod Örnekleri

JavaScript (Fetch API)

// Programlı olarak hesaplama yapma örneği
fetch('https://www.ratias.com/api/calculate?formula=13&val1=1000&val2=200&val3=18&val4=20&lang=tr')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log("Hesaplanan Sonuç:", data.data.result);
      console.log("Açıklama Metni:", data.data.text);
    } else {
      console.error("Hesaplama Hatası:", data.error);
    }
  });

Python

import requests

# Hesaplama endpoint'ini sorgula
params = {
    'formula': 1,
    'val1': 150,
    'val2': 20,
    'lang': 'tr'
}
response = requests.get("https://www.ratias.com/api/calculate", params=params)
data = response.json()

if data['success']:
    print(f"Sonuç: {data['data']['result']}")
    print(f"Açıklama: {data['data']['text']}")

cURL

curl -X GET "https://www.ratias.com/api/calculate?formula=1&val1=150&val2=20&lang=tr"

4. Matematiksel Formüller Referans Tablosu

Aşağıdaki tablo, formül kimliklerini (ID) standart matematiksel denklemlerle ve gerekli parametrelerle eşleştirir:

Formül Kataloğu ve Giriş Parametreleri Referansı
ID	Adı	Matematiksel Formül	Gerekli Girdiler
`formula1`	Yüzde Hesaplama	`(A × B) ÷ 100`	`val1` (A), `val2` (B)
`formula2`	KDV Dahil Hesaplama	`A × (1 + B ÷ 100)`	`val1` (A), `val2` (B)
`formula3`	Matrah Hesaplama	`A ÷ (1 + B ÷ 100)`	`val1` (A), `val2` (B)
`formula4`	KDV Hariç Hesaplama	`A × (1 - B ÷ 100)`	`val1` (A), `val2` (B)
`formula5`	Oran Hesaplama	`(A ÷ B) × 100`	`val1` (A), `val2` (B)
`formula6`	Yüzde Artış Hesaplama	`((A ÷ B) - 1) × 100`	`val1` (A), `val2` (B)
`formula7`	Yüzde Azalış Hesaplama	`((B - A) ÷ B) × 100`	`val1` (A), `val2` (B)
`formula8`	Büyük Sayı Yüzde Hesaplama	`(B ÷ A) × C`	`val1` (A), `val2` (B), `val3` (C)
`formula9`	Yüzde İndirim Hesaplama	`((B ÷ A) - 1) × 100`	`val1` (A), `val2` (B)
`formula10`	Bileşik Büyüme Hesaplama	`A × (1 + B/100)^C`	`val1` (A), `val2` (B), `val3` (C)
`formula11`	Yüzde Farkı Hesaplama	`\|A - B\| ÷ ((A + B) ÷ 2) × 100`	`val1` (A), `val2` (B)
`formula12`	Yüzde Hata Hesaplama	`\|B - A\| ÷ \|A\| × 100`	`val1` (A), `val2` (B)
`formula13`	Net Kâr Hesaplama	`(A / (1 + C/100) - B) * (1 - D/100)`	`val1` (A), `val2` (B), `val3` (C), `val4` (D)

5. Lisans ve Kullanım Koşulları

Ratias Open Math API, MIT Lisansı altında sunulmakta olup, ticari ve ticari olmayan tüm projelerinizde ücretsiz olarak kullanılabilir. Atıfta bulunulması (Ratias platformuna backlink verilmesi) API'nin sürdürülebilirliği açısından önemle rica olunur.

Ratias Açık Matematik API'si