Mit dem Synchronisations Endpunkt startest du eine Ninox-Synchronisation aus einem Skript oder einer anderen Anwendung. Die Antwort ist JSON. Ein Token im Link erlaubt den Aufruf ohne Anmeldung im Browser.
Endpunkt erstellen
- Öffne Automationen → Integrationen und wähle die Ninox-Integration.
- Gehe zu Manuelle Synchronisation → Synchronisations Endpunkt.
- Klicke auf Neuen Link generieren.
- Kopiere die vollständige angezeigte URL einschließlich
?token=…in deine Anwendung.
Verwende die URL aus der Oberfläche. Sie gehört zur Synchronisation deiner Integration und verwendet eine andere Adresse als die öffentliche API zum Lesen von Bankdaten.
Wer den vollständigen Link besitzt, kann die Synchronisation auslösen. Bewahre ihn wie einen Zugangsschlüssel auf und hinterlege ihn nur in Anwendungen, die diese Übertragung starten sollen.
Aufruf
Der Endpunkt akzeptiert POST und GET. Dieses Beispiel setzt voraus, dass KONTOFLUX_SYNC_URL in der Umgebung deines Skripts die kopierte URL enthält:
curl --fail-with-body --request POST "$KONTOFLUX_SYNC_URL"Der Token berechtigt zum Starten dieser Integration. Die Integration muss aktiv sein. Ein bereits laufender Auftrag kann einen weiteren Start verhindern.
Antwort auswerten
Ein erfolgreicher HTTP-Aufruf bedeutet nicht immer, dass der Lauf schon abgeschlossen ist. Prüfe die Felder der JSON-Antwort:
| Felder | Bedeutung |
|---|---|
finished: true, status: "success" | Der Lauf ist abgeschlossen. items und log enthalten das Ergebnis. |
finished: false, status: "running" | Der Lauf wurde eingeplant oder läuft noch. Prüfe das endgültige Ergebnis in Kontoflux.io. |
finished: true, status: "error" | Der Lauf ist fehlgeschlagen. log enthält die Meldungen. |
Bei einer Fehlermeldung prüfst du außerdem den HTTP-Status und den Antworttext. Starte denselben Auftrag nicht fortlaufend neu, während er noch verarbeitet wird.
Link ersetzen oder entziehen
- Neuen Link generieren ersetzt den bisherigen Token. Aktualisiere danach alle Anwendungen, die den alten Link verwenden.
- Link löschen entzieht dem bisherigen Link den Zugriff.
Den sichtbaren Ablauf mit Bankprüfung und Anmeldung findest du beim Quick-Sync-Link.