Ratias fournit une API mathématique gratuite et en libre accès. Les développeurs peuvent accéder par programmation à notre catalogue de 13 formules de pourcentage localisées, ou exécuter des calculs en temps réel directement via nos points d'accès haute performance.
Collection Postman
Téléchargez notre collection Postman préconfigurée contenant les points d'accès des 13 calculs de pourcentage mathématiques pour commencer à tester instantanément.
1. API de Métadonnées des Formules
Récupérez le schéma complet, les paramètres et les descriptions localisées pour les 13 formules mathématiques :
Exemple de Structure de Réponse
{
"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. API de Calcul en Temps Réel
Calculez des valeurs mathématiques de manière dynamique en envoyant des paramètres de requête au point d'accès serverless "calculate". La réponse renvoie le résultat numérique, la formule mathématique et une explication textuelle grammaticalement correcte dans la langue sélectionnée.
Paramètres de Requête (Query Parameters)
| Paramètre | Type | Requis | Description |
|---|---|---|---|
formula | Chaîne / Nombre | Oui | L'identifiant de la formule (par exemple, 1, formula1 à 13). |
val1 | Nombre | Oui | Valeur du premier paramètre (nombre de base, prix de vente, etc.). |
val2 | Nombre | Oui | Valeur du deuxième paramètre (taux de pourcentage, coût, etc.). Non requis pour certains cas particuliers. |
val3 | Nombre | Non | Valeur du troisième paramètre (requis pour les formules 8, 10 et 13). |
val4 | Nombre | Non | Valeur du quatrième paramètre (requis pour la formule 13). |
lang | Chaîne | Non | Langue de sortie : en, tr, de, fr (par défaut : en). |
Exemple de Requête
Exemple de Réponse
{
"success": true,
"formula": "formula1",
"lang": "fr",
"inputs": {
"val1": 150,
"val2": 20
},
"data": {
"result": 30,
"text": "20 % de 150 est 30",
"formula": "(150 × 20) ÷ 100 = 30"
}
}3. Exemples de Code d'Intégration
JavaScript (Fetch API)
// Effectuer un calcul par programmation
fetch('https://www.ratias.com/api/calculate?formula=13&val1=1000&val2=200&val3=18&val4=20&lang=fr')
.then(response => response.json())
.then(data => {
if (data.success) {
console.log("Résultat calculé :", data.data.result);
console.log("Texte de sortie :", data.data.text);
} else {
console.error("Erreur de calcul :", data.error);
}
});Python
import requests
# Interroger le point d'accès de calcul
params = {
'formula': 1,
'val1': 150,
'val2': 20,
'lang': 'fr'
}
response = requests.get("https://www.ratias.com/api/calculate", params=params)
data = response.json()
if data['success']:
print(f"Résultat : {data['data']['result']}")
print(f"Explication : {data['data']['text']}")cURL
curl -X GET "https://www.ratias.com/api/calculate?formula=1&val1=150&val2=20&lang=fr"4. Table de Référence des Formules Mathématiques
Le tableau suivant associe les ID de formule à leurs équations mathématiques standard et aux entrées requises :
| ID | Nom | Formule Mathématique | Entrées Requises |
|---|---|---|---|
formula1 | Calculateur Pourcentage | (A × B) ÷ 100 | val1 (A), val2 (B) |
formula2 | Calcul Pourcentage Ajout | A × (1 + B ÷ 100) | val1 (A), val2 (B) |
formula3 | Calcul Pourcentage Inverse (Excl. TVA) | A ÷ (1 + B ÷ 100) | val1 (A), val2 (B) |
formula4 | Calcul Pourcentage Exclusion | A × (1 - B ÷ 100) | val1 (A), val2 (B) |
formula5 | Calcul Ratio | (A ÷ B) × 100 | val1 (A), val2 (B) |
formula6 | Calcul Augmentation Pourcentage | ((A ÷ B) - 1) × 100 | val1 (A), val2 (B) |
formula7 | Calcul Diminution Pourcentage | ((B - A) ÷ B) × 100 | val1 (A), val2 (B) |
formula8 | Calcul Pourcentage Grands Nombres | (B ÷ A) × C | val1 (A), val2 (B), val3 (C) |
formula9 | Calcul Remise Pourcentage | ((B ÷ A) - 1) × 100 | val1 (A), val2 (B) |
formula10 | Calcul Croissance Composée | A × (1 + B/100)^C | val1 (A), val2 (B), val3 (C) |
formula11 | Calcul Différence Pourcentage | |A - B| ÷ ((A + B) ÷ 2) × 100 | val1 (A), val2 (B) |
formula12 | Calcul Erreur Pourcentage | |B - A| ÷ |A| × 100 | val1 (A), val2 (B) |
formula13 | Calculateur Bénéfice Net | (A / (1 + C/100) - B) * (1 - D/100) | val1 (A), val2 (B), val3 (C), val4 (D) |
5. Licence et Attribution
L'API Ratias Open Math est publiée sous la Licence MIT et peut être utilisée librement à des fins commerciales ou non. L'intégration d'un lien (backlink) vers Ratias est vivement encouragée.