Wie importiere und exportiere ich per JSON?

Ab Tarif Basic

Kurzantwort

JSON funktioniert in beide Richtungen: Der Export liefert deine Assets als JSON-Array mit allen Feldern; der Import nimmt eine .json-Datei mit einem Array von Asset-Objekten (oder einem einzelnen Objekt) entgegen. Pflicht je Objekt sind (wie beim CSV-Import) nur asset_type und name. JSON ist die bessere Wahl, wenn du verschachtelte Werte wie tags (Liste) oder custom_fields (Objekt) übertragen willst, die sich in CSV nicht abbilden lassen.

Voraussetzungen

JSON-Import/-Export ist im Basic-Tarif enthalten. Beim Import zählt das Asset-Limit der Lizenz.

Bereich „Import & Export” öffnen. Wähle in der Navigation den Bereich für Daten (Route /data). Das Upload-Feld akzeptiert laut Hinweis „Unterstützte Formate: CSV, JSON”.

JSON-Datei hochladen. Ziehe deine .json-Datei in das Feld oder wähle sie aus. Eine gültige Datei enthält ein Array von Asset-Objekten:

[
  {
    "asset_type": "hardware",
    "name": "ThinkPad T14 – Vertrieb",
    "serial_number": "PF-3X9K2L",
    "manufacturer": "Lenovo",
    "status": "active",
    "tags": ["notebook", "vertrieb"]
  },
  {
    "asset_type": "network",
    "name": "Core-Switch 01",
    "manufacturer": "Cisco",
    "location": "Rechenzentrum / Rack A1"
  }
]

Import starten. Klicke auf „Import starten”. Das Ergebnis meldet die Zahl der importierten Datensätze.

Screenshot ausstehend import-export-json-01 Upload einer JSON-Datei im Import-Bereich mit Format-Hinweis CSV, JSON

JSON-Dateien werden über dasselbe Upload-Feld importiert wie CSV.
Export als JSON. Für die Gegenrichtung wählst du beim Export das Format JSON und lädst die Datei herunter. Sie enthält alle Felder inklusive tags und custom_fields.

Export als JSON (optional gefiltert nach Typ und Status):

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets/export?fmt=json&asset_type=hardware&status=active" \
  --output assets.json

Die Datei ist ein Array vollständiger Asset-Objekte (gleiches Format wie die API-Antwort beim Anlegen, inklusive id, tenant_id, tags, custom_fields).

Import einer JSON-Datei (multipart/form-data, Feld file):

curl -X POST https://demo.notory.io/api/v1/assets/import \
  -H "Authorization: Bearer inv_dein_token" \
  -F "file=@assets-import.json"

{
  "message": "Successfully imported 2 assets",
  "data": { "count": 2 }
}

Notory erkennt JSON an der Endung .json. Bei anderen Endungen versucht es zuerst JSON zu parsen und fällt dann auf CSV zurück.

Mögliche Fehler: 401 (Token fehlt/ungültig). Ist die Datei kein gültiges JSON und auch nicht als CSV lesbar, schlägt der Import fehl; einzelne ungültige Objekte werden (wie beim CSV-Import) übersprungen.

Was passiert dabei?

Array oder Einzelobjekt: Die Datei darf ein Array von Objekten oder ein einzelnes Objekt enthalten. Alles andere (z. B. eine Zahl oder ein String) wird abgelehnt.
Gleiche Validierung wie CSV: Jedes Objekt wird einzeln gegen das Asset-Schema geprüft; ungültige Objekte werden übersprungen, die gültigen angelegt. Die Antwort zählt nur die Erfolge.
Mehr Datentypen als CSV: tags (Liste), custom_fields (Objekt), Zahlen und Datumsangaben kommen typisiert an. Kein Umweg über Text wie in CSV. Freifelder in custom_fields werden gegen die im Mandanten definierten Freifelder validiert.
Roundtrip mit Vorsicht: Ein JSON-Export lässt sich wieder importieren; unbekannte Felder wie id, tenant_id oder created_at werden dabei ignoriert und neu vergeben. Aber: Es entstehen neue Assets (keine Aktualisierung der alten), denn eine Dublettenprüfung gibt es nicht.
Kodierung: UTF-8; Umlaute sind kein Problem.