À retenir : Pour aider un utilisateur à composer sa routine de soins, votre application doit pouvoir relier les produits et leurs ingrédients aux critères qu’il a choisis. Ce guide montre comment lire les listes d’ingrédients et rechercher leurs fonctions en Node.js avec The Beauty API.
Si une personne recherche des ingrédients hydratants, votre application peut repérer les fonctions humectantes ou émollientes et afficher les ingrédients correspondants. Les fiches produits et les fonctions des ingrédients sont déjà reliées. Vous pouvez vous concentrer sur la façon dont vos utilisateurs composent leur routine.
Lire les ingrédients d’un produit
Commencez par la fiche complète renvoyée par GET /v1/products/{id}. Les ingrédients peuvent être présentés dans une liste unique, des sections nommées ou les composants d’un coffret. Cette fonction parcourt ces structures tout en conservant leurs intitulés :
// Conserver le composant et la section de chaque liste.
function ingredientLists(record, component = null) {
if (Array.isArray(record.components)) {
return record.components.flatMap(part => ingredientLists(part, part.name));
}
if (Array.isArray(record.ingredient_sections)) {
return record.ingredient_sections.map(section => ({
component,
section: section.heading,
ingredients: section.ingredients ?? [],
}));
}
return [{ component, section: null, ingredients: record.ingredients ?? [] }];
}
Repérer les ingrédients correspondant aux préférences choisies
Le champ functions décrit les rôles des ingrédients en cosmétique. Utilisez-le pour repérer les correspondances et afficher les noms qui expliquent chaque suggestion :
function matchFunctions(product, wantedFunctions) {
const wanted = new Set(wantedFunctions.map(value => value.toLowerCase()));
return ingredientLists(product).map(list => ({
component: list.component,
section: list.section,
matches: list.ingredients
.filter(ingredient => (ingredient.functions ?? []).some(
value => wanted.has(value.toLowerCase())
))
.map(ingredient => ({
name: ingredient.name ?? ingredient.label_name,
position: ingredient.position,
functions: ingredient.functions,
})),
}));
}
// product contient la fiche complète récupérée par votre serveur.
const matches = matchFunctions(product, ["humectant", "emollient"]);
console.log(matches);
Votre interface peut ainsi afficher les ingrédients qui remplissent les fonctions recherchées et, pour un coffret, préciser dans quel produit ils se trouvent. Elle aide l’utilisateur à choisir selon ses préférences, sans fournir d’évaluation médicale du produit fini.
S’appuyer sur un dictionnaire commun d’ingrédients
Grâce au dictionnaire INCI, vous retrouvez un même ingrédient dans différents produits sans créer votre propre table de synonymes. L’API fournit aussi les fonctions, identifiants et évaluations de référence disponibles. La documentation des champs vous aide à choisir les informations utiles à votre fonctionnalité.
Pour une application en ligne, récupérez les fiches depuis votre serveur et conservez la clé dans une variable d’environnement. Si vous préférez importer le catalogue dans votre propre base, The Complete Archive fournit des fichiers CSV, JSONL et SQLite avec un guide du schéma. Ses identifiants numériques sont distincts des UUID de l’API.
Construire la routine à partir des résultats
- Commencez par la recherche de produits. L’utilisateur sélectionne ceux qu’il possède ou souhaite essayer.
- Expliquez chaque correspondance. Affichez le nom de l’ingrédient et la fonction associée à la préférence.
- Distinguez les composants d’un coffret. Présentez les résultats sous le composant auquel ils appartiennent.
- Ajoutez les images. Utilisez
image_urldans l’API ouimage_nameavec les fichiers d’images de l’archive.
Notre guide de recommandation de soins présente le parcours complet. La recherche, les correspondances d’ingrédients et les filtres vous donnent les éléments nécessaires pour proposer une routine avec des explications compréhensibles.

