# JSON-Sync Endpunkt

Mit dem JSON Endpunkt zum Synchronisieren kannst du den Sync komplett eingebettet in einer Applikation starten ohne dabei einen Absprung zu Kontoflux.io zu haben.

<figure><img src="/files/Xi6eGuTuZGkyPffXVVjw" alt=""><figcaption></figcaption></figure>

Du erhältst dabei in der Antwort des JSON Endpunkts auch Informationen über den Status des Syncs und die Menge der übertragenen Transaktionen.

{% hint style="warning" %}
Das Ausführen des Syncs kann ein paar Sekunden dauern. Der Request wird so lange offen gelassen. Ist der Sync nach 60 Sekunden noch nicht abgeschlossen, gibt der JSON-Endpunkt eine Schätzung zurück, wie lange der Sync dauern wird.
{% endhint %}

### JSON Endpunkt Link generieren

Du musst zum nutzen des Endpunktes in der Integrationen nach erfolgreichen Einrichten einen Link generieren und kannst Ihn dann zum einbetten kopieren. Dabei wird ein Token generiert und automatisch der URL angehangen. Du kannst jederzeit den Token erneuern oder den Endpunkt gänzlich aktivieren durch Löschen des Tokens.&#x20;

### Parameter

Es funktionieren GET als auch POST Requests an den Endpunkt. Neben den Token, der als GET Parameter mit geschickt wird, sind keine weiteren Parameter notwendig.&#x20;

### JSON Antwort durchgeführten Sync

Sollte der Sync innerhalb einer Minute erledigt sein, käme direkt das Ergebnis des Syncs.

```
{
  "message": "integration sync finished",
  "items": 1568,
  "log": [
    "Log Entries...",
    "... of the Sync ...",
    "... as Array"
  ],
  "combinedLog": "Log Entries as single String"
}
```

### JSON Antwort eingereihter Sync

Wenn ein Sync länger als eine Minute dauert, antwortet der JSON Endpunkt mit einer Zeitschätzung zu wann die Daten Synchronisiert sind.

```
{ 
    message: "integration is scheduled for sync. Estimate: 1 minute", 
    estimation: 1, 
    unit: "minutes" 
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kontoflux.io/konten-synchronisieren/json-sync-endpunkt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.