JSON-Datensätze sicher auf freigegebene Exportfelder reduzieren
Eingehende JSON-Datensätze werden gezielt auf freigegebene Exportfelder reduziert, indem sie automatisiert über einen sicheren Webhook gefiltert werden. Der Ablauf prüft die Eingaben, entfernt nicht erlaubte Felder und liefert bereinigte Datensätze sowie eine Statistik über entfernte Felder zurück. Fehlerhafte Eingaben erhalten eine klare Fehlermeldung. Entwicklern, Datenmanagern und Integratoren bietet dies eine effiziente Lösung zur automatisierten Aufbereitung strukturierter Daten für Exporte, APIs oder Drittsysteme.
Eingehende JSON-Datensätze lassen sich automatisiert über einen POST-Webhook nach einer Liste erlaubter Felder filtern. Der Workflow prüft, ob die Eingaben gültig sind – es müssen nicht-leere Arrays für records und allowedFields vorliegen, keine verbotenen Feldnamen verwendet werden und alle records als Objekte strukturiert sein. Anschließend werden alle nicht erlaubten Felder aus jedem Datensatz entfernt. Das Ergebnis umfasst die bereinigten Datensätze, die Anzahl der entfernten Felder sowie die Gesamtzahl der Datensätze. Bei fehlerhaften Eingaben erfolgt eine Rückmeldung mit klarer Fehlermeldung und dem Status 'error'. Die Lösung eignet sich besonders für Entwickler, Datenmanager und Integratoren, die strukturierte Daten für Exporte, Schnittstellen oder Drittsysteme automatisiert aufbereiten möchten. Die Webhook-Authentifizierung muss in n8n separat eingerichtet werden, um unbefugten Zugriff zu verhindern. Ausführungsdaten werden in n8n gespeichert und sollten entsprechend verwaltet werden. Die Feldliste ist pro Request statisch, kann aber flexibel angepasst werden. Der Workflow ist universell einsetzbar, führt jedoch keine vollständige API-Validierung oder Transformation durch – es werden ausschließlich die erlaubten Felder übernommen, ohne weitere Prüfungen oder Umwandlungen.
KI-generiertes Bild
Geschätzte Zeitersparnis: 3–10 Minuten je AnwendungSchätzung im Detail
Mögliche monatliche Ersparnis
6–200 Minuten
Angenommene Nutzung
2–20 Mal pro Monat
Einmaliger Einrichtungsaufwand
10 Minuten
Geschätzter monatlicher Wartungsaufwand
2 Minuten
Unverbindliche Schätzung auf Grundlage des analysierten Arbeitsablaufs. Die tatsächliche Ersparnis hängt von Aufgabe, Eingaben, Erfahrung und Arbeitsweise ab.
Installation
1. Workflow-JSON in n8n importieren.
2. Webhook-Node prüfen und ggf. Pfad anpassen.
3. Test-Listener im Workflow starten und die angezeigte Test-URL kopieren.
4. In n8n die Webhook-Authentifizierung einrichten (z.B. Basic Auth oder Header), um unbefugten Zugriff zu verhindern.
5. Mit einem Tool wie curl oder Postman einen POST-Request mit Content-Type application/json an die Test-URL senden (siehe Nutzungsbeispiel).
6. Ergebnis prüfen. Bei Erfolg werden die gefilterten Datensätze und Statistiken zurückgegeben, bei Fehler eine strukturierte Fehlermeldung.
7. Nach erfolgreichem Test Workflow veröffentlichen/aktivieren und die Produktions-URL aus dem Webhook-Node verwenden.
8. Optional: Ausführungsdaten-Aufbewahrung und Zugriffsrechte in n8n konfigurieren.
Nutzung
1. Senden Sie einen POST-Request mit folgendem JSON an die Webhook-URL:
```json
{
"records": [
{"id": 1, "name": "Max", "email": "max@example.com", "role": "admin"},
{"id": 2, "name": "Anna", "email": "anna@example.com", "role": "user"}
],
"allowedFields": ["id", "name"]
}
```
Erwartete Antwort:
```json
{
"status": "success",
"filteredRecords": [
{"id": 1, "name": "Max"},
{"id": 2, "name": "Anna"}
],
"removedFieldCount": 4,
"recordCount": 2
}
```
HTTP-Status: 200
2. Bei ungültigen Eingaben (z.B. fehlende Felder oder falsche Typen):
```json
{
"records": [],
"allowedFields": ["id"]
}
```
Antwort:
```json
{
"status": "error",
"message": "records und allowedFields müssen nicht-leere Arrays sein."
}
```
HTTP-Status: 200
3. Die Webhook-Authentifizierung muss in n8n separat aktiviert werden. Ohne Authentifizierung ist der Endpoint öffentlich erreichbar.
4. Die Feldnamen in allowedFields dürfen keine leeren Strings oder reservierte Namen wie '__proto__' enthalten.
5. Die Ausführungsdaten werden in n8n gespeichert und sollten regelmäßig verwaltet werden.
Benötigte Verbindungen und APIs
API-Verbindungen
Im Workflow-JSON wurden keine gespeicherten API-Zugangsdaten erkannt. Prüfe vor der Aktivierung trotzdem Webhooks, Zielsysteme, Zugangsdaten und Datenschutz.
Nodes
WebhookCodeRespond to Webhook
Isolierter Funktionstest bestanden
Optionaler isolierter Funktionstest
Geprüft wurde der isolierte Datenfluss ohne externe Dienste oder Zugangsdaten.
✓ Normalfall mit vollständigen DatenPrüft den vollständigen Standardablauf mit gültigen Beispieldaten.Isolierter Funktionstest bestanden✓ Variante oder GrenzfallPrüft eine zulässige Variante oder einen wichtigen Grenzfall.Isolierter Funktionstest bestanden✓ Zusätzliche VerarbeitungsregelPrüft die zusätzliche fachliche Verarbeitungsregel dieses Workflows.Isolierter Funktionstest bestanden✓ Ungültige oder unvollständige EingabePrüft, ob ungültige oder unvollständige Daten kontrolliert abgewiesen werden.Isolierter Funktionstest bestanden✓ Leere EingabePrüft, ob eine leere Anfrage kontrolliert beantwortet wird.Isolierter Funktionstest bestanden
