Das Wichtigste: Damit Ihre Anwendung Nutzern beim Zusammenstellen einer Hautpflegeroutine helfen kann, muss sie Produkte und deren Inhaltsstoffe mit den gewählten Kriterien verknüpfen können. Dieser Leitfaden zeigt, wie Sie mit The Beauty API in Node.js Inhaltsstofflisten auslesen und nach Funktionen suchen.
Sucht ein Nutzer nach feuchtigkeitsspendenden Inhaltsstoffen, kann Ihre Anwendung die entsprechenden Funktionen im Datensatz finden und passende Inhaltsstoffe anzeigen. Die Produktdatensätze und Inhaltsstofffunktionen sind bereits verknüpft. So können Sie sich darauf konzentrieren, wie Ihre Nutzer ihre Routine zusammenstellen.
Die Inhaltsstoffe eines Produkts auslesen
Beginnen Sie mit dem vollständigen Datensatz aus GET /v1/products/{id}. Inhaltsstoffe können in einer einzigen Liste, in benannten Abschnitten oder in den Bestandteilen eines Sets vorliegen. Diese Funktion durchläuft die Strukturen und behält die jeweiligen Bezeichnungen bei:
// Bestandteil und Abschnitt jeder Liste beibehalten.
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 ?? [] }];
}
Inhaltsstoffe nach den Wünschen Ihrer Nutzer auswählen
Das Feld functions beschreibt, welche Aufgaben ein Inhaltsstoff in Kosmetika erfüllt. Suchen Sie nach den gewünschten Funktionen und zeigen Sie die zugehörigen Inhaltsstoffnamen an. So wird nachvollziehbar, warum Ihre Anwendung ein Produkt vorschlägt:
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 enthält den vollständigen, von Ihrem Server abgerufenen Datensatz.
const matches = matchFunctions(product, ["humectant", "emollient"]);
console.log(matches);
Ihre Oberfläche kann so anzeigen, welche Inhaltsstoffe die gesuchten Funktionen erfüllen und in welchem Produkt eines Sets sie enthalten sind. Sie unterstützt die Auswahl nach persönlichen Vorlieben, ohne eine medizinische Bewertung des fertigen Produkts abzugeben.
Ein gemeinsames Inhaltsstoffverzeichnis nutzen
Mit dem INCI-Verzeichnis finden Sie denselben Inhaltsstoff in unterschiedlichen Produkten, ohne eine eigene Synonymtabelle aufbauen zu müssen. Die API liefert außerdem verfügbare Funktionen, Kennungen und Referenzbewertungen. Die Felddokumentation beschreibt, welche Informationen Sie für Ihre Anwendung nutzen können.
Rufen Sie Datensätze für eine Online-Anwendung von Ihrem Server aus ab und speichern Sie den Schlüssel in einer Umgebungsvariablen. Wenn Sie den Katalog lieber in Ihre eigene Datenbank importieren möchten, liefert The Complete Archive CSV-, JSONL- und SQLite-Dateien mit einer Beschreibung des Schemas. Die numerischen Kennungen des Archivs unterscheiden sich von den UUIDs der API.
Aus den Ergebnissen eine Routine zusammenstellen
- Beginnen Sie mit der Produktsuche. Nutzer wählen die Produkte aus, die sie besitzen oder ausprobieren möchten.
- Erklären Sie jede Übereinstimmung. Zeigen Sie den Inhaltsstoffnamen und die Funktion, die den gewählten Kriterien entspricht.
- Trennen Sie die Bestandteile eines Sets. Zeigen Sie Ergebnisse unter dem Bestandteil an, zu dem sie gehören.
- Ergänzen Sie Bilder. Nutzen Sie
image_urlin der API oderimage_namezusammen mit den Bilddateien des Archivs.
Unser Leitfaden für Hautpflegeempfehlungen beschreibt den vollständigen Ablauf. Suche, Inhaltsstoffabgleich und Filter liefern Ihnen die Bausteine für Pflegeroutinen mit nachvollziehbaren Empfehlungen.

