Abrufen der Formulardaten mit der Kizeo Forms API

Wenn Sie erfasste Daten aus Ihren Formularen abrufen und automatisch in Ihr CRM, ERP oder eine andere Unternehmenssoftware einfügen möchten, müssen Sie unsere API verwenden. Der Ablauf ist einfach, erfordert jedoch die Einhaltung eines präzisen Protokolls. Dieser Prozess ist dem Vorgehen ähnlich, das Sie auch bei der Nutzung der Kizeo Forms Web-Oberfläche anwenden

1. Die Identifikation

Wie auch in der Web-Oberfläche besteht der erste Schritt darin, sich zu identifizieren. Dafür benötigen Sie ein Token. Dieses ermöglicht Ihnen den Zugriff auf Ihre auf unseren Servern gespeicherten Daten über unsere API. Wenn Sie noch kein Token besitzen, lesen Sie bitte das Tutorial Einstieg mit der Kizeo Forms API, um zu erfahren, wie Sie es erhalten.

2. Abrufen der Datenliste des Formulars

In der Kizeo Forms Web-Oberfläche gehen Sie, nachdem Sie sich angemeldet haben, in den Chronologischen Verlauf und wählen Ihr Formular aus, um alle zugehörigen Datensätze anzuzeigen. Mit der API verläuft der Prozess ähnlich. Sobald Sie Ihr Token erhalten haben, können Sie auf die auf unseren Servern gespeicherten Informationen zugreifen. Die Vorgehensweise entspricht der Nutzung der Web-Oberfläche. Um auf Ihre Daten zuzugreifen, müssen Sie zunächst den Verlauf abfragen. Dort werden alle Datensätze angezeigt, die einem bestimmten Formular zugeordnet sind.

.

https://forms.kizeo.com/rest/v3/forms/{formId}/data/unread/{flag}/100 : Diese URL ermöglicht es Ihnen, die Liste der Datensätze abzurufen, die noch nicht mit einem {flag} markiert wurden. Für weitere Informationen zur Nutzung und zu den Optionen dieser Abfrage folgen Sie bitte diesem Link.

3. Wählen Sie anschließend den Datensatz aus, den Sie vollständig abrufen möchten

https://forms.kizeo.com/rest/v3/forms/{formId}/data/{dataId} : Diese URL ermöglicht es Ihnen, den vollständigen Datensatz abzurufen.

Greifen Sie auf die Informationen zu, um zu erfahren, wie Sie diese Abfragen verwenden können

4. Die Optionen

Um zu vermeiden, dass Daten erneut gelesen werden, können Sie diese als gelesen markieren.

https://forms.kizeo.com/rest/v3/forms/{formId}/markasreadbyaction/{flag} : Diese URL ermöglicht es Ihnen, einen Datensatz für ein bestimmtes {flag} als gelesen zu markieren.
Der Kizeo Forms Webservice bietet Ihnen außerdem die Möglichkeit, eine erweiterte Suche in Ihren Daten durchzuführen. Mit dieser Funktion können Sie die Liste der Datensätze eines Formulars abrufen, die einer spezifischen Suche in einem oder mehreren Feldern entsprechen.
https://forms.kizeo.com/rest/v3/forms/{formId}/data/advanced : Diese URL führt Sie zur erweiterten Suche. Dort finden Sie alle Informationen zur Nutzung dieser Abfrage.