search_nodes

LesenSeit v1.0

Nach Knoten (Instanzen) im Modell suchen. Filtern nach Typ, Name, Beschreibung, Eigenschaftswerten oder Ordner. Gibt Zusammenfassungen zurück — verwenden Sie get_node_details für vollständige Informationen.

Parameter

NameTypPflichtfeldStandardBeschreibung
folder_idString[search_nodes] Ergebnisse auf Knoten innerhalb dieses Ordners beschränken (UUID).
localeString[search_nodes] Optionaler Gebietsschema-Code (z. B. 'de', 'en') für übersetzte Labels und Beschreibungen.
offsetNumber0[search_nodes] Die ersten N Ergebnisse für die Paginierung überspringen.
propertiesObject[search_nodes] Nach Eigenschaftswerten filtern. Schlüssel sind Eigenschaftsnamen, Werte sind Suchausdrücke (Teilstring-Abgleich).
name_containsString[search_nodes] Nur Knoten zurückgeben, deren Label diesen Text enthält (Groß-/Kleinschreibung wird ignoriert).
description_containsString[search_nodes] Nur Knoten zurückgeben, deren Beschreibung diesen Text enthält.
node_typeString[search_nodes] Ergebnisse auf Knoten dieses Typnamens filtern (Groß-/Kleinschreibung wird beim Abgleich mit Metamodell-Typnamen ignoriert).
limitNumber50[search_nodes] Maximale Anzahl zurückgegebener Ergebnisse. Standard: 50, Maximum: 200.

Beispielanfrage

{"node_type": "Feature", "properties": {"status": "planned"}, "limit": 50}

Beispielantwort

{"total_count": 12, "nodes": [{"id": "uuid-1", "label": "OAuth Integration", "type": "Feature", "preview": "status: planned, priority: 1"}]}