Zum Inhalt springen
craftdexDocs

craftdex-export.json

Aufbau der maschinenlesbaren Exportdatei, Format Version 1.

craftdex-export.json liegt im Stammverzeichnis der ZIP-Datei. Sie enthält alle Tabellen vollständig und ein Verzeichnis aller Dateien. Für Programme, die Daten aus CraftDex übernehmen, ist sie die maßgebliche Quelle: Anders als bei den CSV-Dateien bleiben Zahlen, Wahrheitswerte, Listen und null als solche erhalten.

Aufbau

craftdex-export.json (gekürzt)
{
  "format": "craftdex-export",
  "version": 1,
  "created_at": "2026-11-20T14:05:00.000Z",
  "company": { "id": "5b0c…", "name": "Musterbau GmbH" },
  "excluded": ["users.pin_hash", "users.push_token", "mail_accounts.secret"],
  "tables": {
    "users": [{ "id": "a1f3…", "name": "Max Mustermann", "role": "worker" }],
    "sites": [{ "id": "c7e2…", "name": "Neubau Lindenstraße", "status": "aktiv" }]
  },
  "files": [
    {
      "bucket": "site-photos",
      "path": "c7e2…/1795190678846.jpg",
      "zip_path": "dateien/site-photos/c7e2…/1795190678846.jpg",
      "size": 482113,
      "sha256": "9f2b…",
      "content_type": "image/jpeg"
    }
  ]
}

Felder

FeldTypBedeutung
formatTextimmer craftdex-export
versionZahlVersion des Formats, derzeit 1
created_atZeitpunkt (UTC)wann der Export erstellt wurde
companyObjektid und name des Betriebs
excludedListeSpalten, die bewusst nicht exportiert werden, als tabelle.spalte (warum)
tablesObjektje Tabelle eine Liste aller Zeilen; Schlüssel ist der Tabellenname, die Zeilen haben die Spalten aus Tabellen und Spalten
filesListealle Dateien des Betriebs, siehe unten

Einträge in files

FeldBedeutung
bucketAblage in CraftDex, zum Beispiel site-photos
pathPfad innerhalb der Ablage, ohne die Kennung des Betriebs
zip_pathPfad der Datei in der ZIP-Datei
sizeGröße in Byte
sha256SHA-256-Prüfsumme, hexadezimal (prüfen)
content_typeDateityp, soweit bekannt, sonst null

Reihenfolge der Zeilen

Die Zeilen jeder Tabelle sind stabil sortiert, in der Regel nach id. Zwei Exporte desselben Stands ergeben dieselbe Reihenfolge.

Versionen

version wird erhöht, wenn sich das Format so ändert, dass ein Programm für die alte Version die Datei nicht mehr richtig lesen würde, etwa wenn ein Feld wegfällt oder seine Bedeutung ändert. Neue Tabellen oder neue Spalten erhöhen die Version nicht; Programme sollten unbekannte Tabellen und Spalten deshalb überspringen. Alle Änderungen stehen unter Änderungen.

Auf dieser Seite