Kostenlose Entwickler-API (JSON)

Ratias bietet eine kostenlose mathematische API mit offenem Zugang. Entwickler können programmgesteuert auf unseren Katalog von 13 lokalisierten Prozentformeln zugreifen oder Berechnungen in Echtzeit über unsere leistungsstarken Endpunkte ausführen.

Postman-Sammlung

Laden Sie unsere vorkonfigurierte Postman-Sammlung mit allen 13 mathematischen Prozentberechnungs-Endpunkten herunter, um sofort mit dem Testen zu beginnen.

Sammlung herunterladen

1. Formel-Metadaten-API

Rufen Sie das vollständige Schema, die Parameter und die lokalisierten Beschreibungen für alle 13 mathematischen Formeln ab:

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

Beispiel für die Antwortstruktur

{
  "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. Echtzeit-Berechnungs-API

Berechnen Sie mathematische Werte dynamisch, indem Sie Abfrageparameter an den Serverless-Endpunkt "calculate" senden. Die Antwort liefert das numerische Ergebnis, die mathematische Formel und eine grammatikalisch korrekte Beschreibung in der ausgewählten Sprache.

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

Abfrageparameter (Query Parameters)

Beschreibung der API-Abfrageparameter
Parameter	Typ	Erforderlich	Beschreibung
`formula`	String / Zahl	Ja	Die Formelkennung (z. B. `1`, `formula1` bis `13`).
`val1`	Zahl	Ja	Erster Parameterwert (Grundwert, Verkaufspreis usw.).
`val2`	Zahl	Ja	Zweiter Parameterwert (Prozentsatz, Kosten usw.). In bestimmten Sonderfällen nicht erforderlich.
`val3`	Zahl	Nein	Dritter Parameterwert (erforderlich für die Formeln 8, 10 und 13).
`val4`	Zahl	Nein	Vierter Parameterwert (erforderlich für Formel 13).
`lang`	String	Nein	Ausgabesprache: `en`, `tr`, `de`, `fr` (Standard: `en`).

Beispiel-Anfrage

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

Beispiel-Antwort

{
  "success": true,
  "formula": "formula1",
  "lang": "de",
  "inputs": {
    "val1": 150,
    "val2": 20
  },
  "data": {
    "result": 30,
    "text": "20% von 150 ist 30",
    "formula": "(150 × 20) ÷ 100 = 30"
  }
}

3. Code-Beispiele zur Integration

JavaScript (Fetch API)

// Eine Berechnung programmgesteuert durchführen
fetch('https://www.ratias.com/api/calculate?formula=13&val1=1000&val2=200&val3=18&val4=20&lang=de')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log("Berechnetes Ergebnis:", data.data.result);
      console.log("Ausgabetext:", data.data.text);
    } else {
      console.error("Berechnungsfehler:", data.error);
    }
  });

Python

import requests

# Abfrage des Berechnungs-Endpunkts
params = {
    'formula': 1,
    'val1': 150,
    'val2': 20,
    'lang': 'de'
}
response = requests.get("https://www.ratias.com/api/calculate", params=params)
data = response.json()

if data['success']:
    print(f"Ergebnis: {data['data']['result']}")
    print(f"Beschreibung: {data['data']['text']}")

cURL

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

4. Mathematische Formel-Referenztabelle

Die folgende Tabelle ordnet die Formel-IDs ihren standardmäßigen mathematischen Gleichungen und den erforderlichen Eingaben zu:

Referenz für Formelkatalog und Eingaben
ID	Name	Mathematische Formel	Erforderliche Eingaben
`formula1`	Prozentrechner	`(A × B) ÷ 100`	`val1` (A), `val2` (B)
`formula2`	Mehrwertsteuer Hinzurechnen	`A × (1 + B ÷ 100)`	`val1` (A), `val2` (B)
`formula3`	Grundwert Berechnen (Exkl. MwSt.)	`A ÷ (1 + B ÷ 100)`	`val1` (A), `val2` (B)
`formula4`	Mehrwertsteuer Herausrechnen	`A × (1 - B ÷ 100)`	`val1` (A), `val2` (B)
`formula5`	Verhältnisrechner	`(A ÷ B) × 100`	`val1` (A), `val2` (B)
`formula6`	Prozentuale Zunahme	`((A ÷ B) - 1) × 100`	`val1` (A), `val2` (B)
`formula7`	Prozentuale Abnahme	`((B - A) ÷ B) × 100`	`val1` (A), `val2` (B)
`formula8`	Große Zahlen Prozentrechner	`(B ÷ A) × C`	`val1` (A), `val2` (B), `val3` (C)
`formula9`	Rabattrechner	`((B ÷ A) - 1) × 100`	`val1` (A), `val2` (B)
`formula10`	Zinseszinsrechner	`A × (1 + B/100)^C`	`val1` (A), `val2` (B), `val3` (C)
`formula11`	Prozentuale Differenz	`\|A - B\| ÷ ((A + B) ÷ 2) × 100`	`val1` (A), `val2` (B)
`formula12`	Prozentualer Fehler	`\|B - A\| ÷ \|A\| × 100`	`val1` (A), `val2` (B)
`formula13`	Nettogewinn-Rechner	`(A / (1 + C/100) - B) * (1 - D/100)`	`val1` (A), `val2` (B), `val3` (C), `val4` (D)

5. Lizenz und Namensnennung

Die Ratias Open Math API wird unter der MIT-Lizenz veröffentlicht und kann sowohl für kommerzielle als auch für nicht-kommerzielle Zwecke frei genutzt werden. Die Verlinkung auf Ratias als Datenquelle wird sehr geschätzt.

Ratias Offene Mathe-API