Daten aus einer externen API importieren
Der Import-Assistent holt Einträge aus einer anderen API, ordnet Felder zu, macht einen Probelauf und importiert im Hintergrund.
Mit dem Import-Assistenten übernimmst du Daten aus einem anderen System – etwa einem alten CMS, einer Warenwirtschaft oder einer Tabelle mit JSON-Schnittstelle. Du startest ihn unter Datensätze → Importieren. Importieren lässt sich in jeden Datentyp, der kein Singleton ist.
1. Quelle
| Feld | Beispiel |
|---|---|
| Name der Quelle | Altes CMS – Referenzen |
| API-Adresse (URL) | https://api.example.com/v1/projects |
| HTTP-Methode | GET oder POST |
| Authentifizierung | Keine, Bearer Token oder API Key |
| Pfad zur Datensatz-Liste | Wo die Einträge in der Antwort stehen, z. B. data.items |
| Abgleichsfeld | Feld, an dem vorhandene Einträge erkannt und aktualisiert werden, z. B. slug |
Klicke auf Verbindung testen. Bei Erfolg lädt Mosaio Beispieldatensätze.
2. Mapping
Ordne jedem Feld deines Datentyps ein Feld der Quelle zu oder wähle — ignorieren —. Für Referenzfelder gibst du an, über welches Feld der verknüpfte Eintrag gefunden wird (z. B. slug).
3. Probelauf
Der Probelauf prüft alle Datensätze, ohne sie zu speichern, und listet Warnungen. Erst nach einem erfolgreichen Probelauf kannst du importieren.
4. Import
Klicke auf Import starten. Der Import läuft im Hintergrund; du wirst benachrichtigt, sobald er abgeschlossen ist.
Ein gestarteter Import kann nicht rückgängig gemacht werden. Teste mit einem duplizierten oder neuen Datentyp, wenn du unsicher bist.
Konnten einzelne Zeilen nicht übernommen werden, meldet Mosaio „Import teilweise abgeschlossen“.
Unser Support antwortet in der Regel innerhalb eines Werktags.