[ API.DOCS ]
> Documentation officielle de l'API REST Rétrolfact.
> Format de réponse : JSON (UTF-8)
> Format de réponse : JSON (UTF-8)
GET /api/get_aliments.php
Description : Retourne la liste complète des aliments disponibles dans la matrice, avec leurs profils gustatifs de base (Langue).
// Exemple de réponse JSON
[
{
"id": 1,
"nom": "Fraise",
"icone": "🍓",
"slogan": "L'illusion sucrée",
"categorie": "FRUIT",
"gout_sucre": 4,
"gout_acide": 3,
"gout_sale": 0,
"gout_amer": 0,
"gout_umami": 0
},
// ...
]
GET /api/get_details.php?id={id}
Description : Retourne les détails complets d'un aliment spécifique et le tableau de toutes les molécules olfactives qui le composent (triées par intensité).
Paramètres :
- id (int) : L'identifiant unique de l'aliment.
// Exemple de réponse JSON pour ?id=1
{
"aliment": {
"id": 1,
"nom": "Fraise",
// ... autres données de l'aliment
},
"molecules": [
{
"id": 2,
"nom_scientifique": "cis-3-Hexenol",
"surnom": "L'herbe fraîchement coupée",
"explication": "Fermez les yeux...",
"intensite": 3
}
// ...
]
}
GET /api/get_molecule.php?id={mol_id}&aliment_id={al_id}
Description : Retourne les informations éducatives d'une molécule, ainsi que la liste des autres aliments de la base de données qui partagent cette même molécule (le croisement inattendu).
Paramètres :
- id (int) : L'ID de la molécule.
- aliment_id (int, optionnel) : L'ID de l'aliment actuel pour l'exclure des résultats croisés.
// Exemple de réponse JSON
{
"molecule": {
"id": 18,
"nom_scientifique": "Benzaldéhyde",
"surnom": "Le piège de la cerise",
"explication": "C'est l'odeur typique de l'amande amère..."
},
"autres_aliments": [
{
"id": 18,
"nom": "Amande",
"icone": "🌰"
}
]
}