Die Kizeo Forms API (REST V3) verwenden

Schritt 1: Die Grundlagen

Der Vorteil einer (RESTful)API besteht darin, dass sie einfach mit jeder Programmiersprache verwendet werden kann, die in der Lage ist, HTTPS-Anfragen an unsere Server mit json-Daten zu senden. Hier ist eine nicht abschließende Liste von verwendbaren Programmiersprachen :

• C#
• C++
• Go
• Java
• Javascript
• Objective C
• Perl
• PHP
• Python
• Ruby
• Etc.

Anschließend finden Sie die wichtigsten Links, die Ihnen bei der Entwicklung Ihrer Anwendung mit der Kizeo Forms API hilfreich sein werden :

• Swagger-Dokumentation : https://forms.kizeo.com/rest/v3/doc (diese Präsentation der Funktionen ermöglicht es, die API-Funktionen einfach zu testen).
• API-Root : https://forms.kizeo.com/rest/v3/ (zum Beispiel, um die Funktion forms aufzurufen, verwenden Sie https://forms.kizeo.com/rest/v3/forms).

Token-Abruf

Um Zugriff auf alle Funktionen zu erhalten, müssen Sie die folgende Zeile im Header Ihrer HTTPS-Anfragen einfügen :

Authorization: YOUR_TOKEN

Um das Token zu erhalten, müssen Sie eine Anfrage per E-Mail an unseren Support-Service senden (support@kizeo.com). Die Anfrage muss von einem Administrator gesendet werden (die E-Mail-Adresse des Absenders muss mit der im Kizeo Forms-Konto hinterlegten E-Mail-Adresse übereinstimmen).

In dieser Anfrage müssen folgende Angaben gemacht werden :

• Die Firmenkennung
• Die Benutzerkennung, für die das Token erstellt werden soll (Administrator oder Gruppenleiter)

Wenn Sie unsere Codebeispiele nicht zum Laufen bringen und eine Fehlermeldung wie das folgende Beispiel erhalten :

Error : Call to undefined function curl_init(). // Ou une autre fonction dépendante de cURL

Keine Panik! Wir empfehlen Ihnen, die folgenden Überprüfungen durchzuführen :

Wenn Sie WAMP verwenden, müssen Sie einfach die Erweiterung aktivieren, indem Sie auf php_curl unter PHP->PHP extensions klicken. Andernfalls lesen Sie bitte weiter.

Schritt 1: Aktivierung der PHP cURL-Erweiterung

Zuerst öffnen Sie Ihre Datei php.ini und suchen Sie nach der folgenden Zeile :

;extension=php_curl.dll

Sobald Sie diese Zeile gefunden haben, müssen Sie sie aktivieren. Entfernen Sie dazu das ";" am Anfang der Zeile und speichern Sie die Datei.

Schritt 2: Ändern der Umgebungsvariablen

Falls dies noch nicht geschehen ist, müssen Sie zur Ausführung von cURL die Umgebungsvariable PATH anpassen.

Wenn Sie nicht wissen, wie Sie diese Variable ändern, finden Sie hier eine Anleitung (unter Windows 10) :

• Öffnen Sie den Datei-Explorer.
• Klicken Sie mit der rechten Maustaste auf Dieser PC und anschließend mit der linken Maustaste auf Eigenschaften.
• Klicken Sie auf Erweiterte Systemeinstellungen.
• Im Reiter Erweiterte Systemeinstellungen, klicken Sie auf Umgebungsvariablen.
• Wählen Sie die Variable mit dem Namen Path aus und klicken Sie auf Bearbeiten.
• Geben Sie den Pfad zum PHP-Verzeichnis ein und klicken Sie auf Ok.
• Klicken Sie auf Übernehmen.

Schritt 3: Apache-Dienst neu starten

Nachdem Sie den Apache-Dienst neu gestartet haben, damit die vorgenommenen Änderungen übernommen werden, sollte die cURL-Bibliothek einsatzbereit sein.