Zur Dokumentation springen
API

Ein Formular aus einem Briefing entwerfen

Ein Designer baut aus einem schriftlichen Briefing ein neues Anmeldeformular und speichert es als Entwurf, wie „Mit KI erstellen“ auf der Seite „Formulare“ der App.

POST/forms/design

Führt den echten Aufruf in Ihrem Workspace aus.

POST /forms/design

Ein Designer baut aus einem schriftlichen Briefing ein neues Anmeldeformular und speichert es als Entwurf, wie „Mit KI erstellen“ auf der Seite „Formulare“ der App.

Beispiel

Erfordert forms:write. brief sagt, was das Formular fragen und sagen soll, bis zu 4.000 Zeichen. name ist optional, und der Designer benennt das Formular, wenn Sie es weglassen.

curl
curl -X POST "$OE/forms/design" -H "$AUTH" -H 'content-type: application/json' -d '{  "brief": "A waitlist for our beta: email, first name and company, with a line on what joining means. A dark green button that says Join the waitlist."}'
Antwort
{  "object": "form",  "id": "frm_7d1f3b5a9c2e48f06b1d3f5a",  "name": "Beta waitlist",  "status": "draft",  "design": {    "notes": ["Made the company field optional, since the brief did not ask for it to be required."]  }}

Die Antwort ist das ganze Formular, wie GET /forms/{id} es liefert, mit design.notes dazu, was der Designer angepasst hat. Veröffentlichen Sie es mit POST /forms/{id}/publish.

Es verbraucht eine KI-Aktion und kann bis zu einer halben Minute dauern. Ein Design, das sich nicht gültig machen lässt, ergibt 422 invalid_form, ein Workspace, der schon so viele Formulare hat wie erlaubt, 422 workspace_limit_reached, ein Server ohne Modell 409 ai_not_configured und ein Workspace ohne verbleibende KI-Aktionen 429 ai_quota_exceeded. In keinem Fall wird etwas erstellt.

Referenz