API Endpoint-Erstellung
Mit unserer Endpoint-Erstellungs-API können Sie programmgesteuert neue Formularverbindungen anlegen. Die API eignet sich für den Einsatz durch KI-Tools und Agenten, die damit eigenständig Formular-Endpoints einrichten können.
Die API liefert die Antwort als JSON, in der Struktur wie bei Beispielantwort dargestellt.
Request
Die Anfrage muss als POST-Request mit dem Content-Type application/json an diese Adresse erfolgen:
POST https://form.taxi/api/v1/create-endpointDer Request-Body muss als JSON übermittelt werden. Eine Authentifizierung ist nicht erforderlich.
Sendedaten
Folgende Felder können im JSON-Body übergeben werden:
email (erforderlich)
Die E-Mail-Adresse, an die Formularsendungen zugestellt werden. Sie dient gleichzeitig als Benutzername für das neu angelegte Konto.
form_name (erforderlich)
Der Name des Formulars, z. B. „Kontaktformular".
language (erforderlich)
Die Sprache für das Konto und die E-Mail-Benachrichtigungen. Mögliche Werte: de, en
website_url (optional)
Die URL der Website, auf der das Formular eingesetzt wird.
timezone (optional)
Die Zeitzone des Kontos als IANA-Zeitzonenbezeichner, z. B. Europe/Vienna. Standardmäßig wird UTC verwendet.
Beispiel-Request
POST https://form.taxi/api/v1/create-endpoint
Content-Type: application/json
{
"email": "kontakt@domain.com",
"form_name": "Kontaktformular",
"website_url": "https://domain.com",
"language": "de",
"timezone": "Europe/Vienna"
}Beispielantwort
Bei erfolgreichem Erstellen des Endpoints antwortet die API mit HTTP-Status 201 und folgendem JSON:
{
"success": true,
"endpoint_url": "https://form.taxi/s/FORM_CODE"
}Die zurückgegebene endpoint_url wird direkt als action-Attribut im HTML-Formular eingesetzt:
<form action="https://form.taxi/s/FORM_CODE" method="POST">
...
</form>Fehlercodes
Schlägt die Anfrage fehl, enthält die Antwort einen Fehlercode im Feld error:
| HTTP-Status | Fehlercode | Bedeutung |
|---|---|---|
| 400 | content_error | Der Request-Body konnte nicht als JSON verarbeitet werden. |
| 409 | email_exists | Bererits Account mit dieser E-Mail-Adresse registriert. |
| 415 | contenttype_error | Der Content-Type-Header fehlt oder ist nicht application/json. |
| 422 | validation_error | Ungültige oder fehlende Pflichtfelder. |
Beispiel: E-Mail bereits vorhanden (409)
{
"success": false,
"error": "email_exists",
"message": "This email address is already registered. Please log in to create an endpoint: https://form.taxi/panel/login"
}OpenAPI-Spezifikation
Die vollständige Spezifikation dieser API steht hier im OpenAPI-Format zur Verfügung: