API
요청으로 양식 디자인
디자이너가 글로 쓴 요청에서 새 가입 양식을 만들어 초안으로 저장합니다. 앱의 양식 페이지에 있는 AI로 만들기와 같습니다.
POST/forms/design
워크스페이스에 실제 호출을 실행합니다.
POST /forms/design
디자이너가 글로 쓴 요청에서 새 가입 양식을 만들어 초안으로 저장합니다. 앱의 양식 페이지에 있는 AI로 만들기와 같습니다.
예시
forms:write가 필요합니다. brief에는 양식이 묻고 말할 내용을 최대 4,000자로 씁니다. name은 선택이며, 빼면 디자이너가 양식 이름을 짓습니다.
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."}'{ "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."] }}응답은 GET /forms/{id}가 돌려주는 것과 같은 양식 전체이며, 디자이너가 조정한 내용이 design.notes에 담깁니다. POST /forms/{id}/publish로 게시하세요.
AI 작업 1회를 쓰고 최대 30초가 걸릴 수 있습니다. 유효하게 만들 수 없는 디자인은 422 invalid_form, 이미 한도만큼 양식이 있는 워크스페이스는 422 workspace_limit_reached, 모델이 없는 서버는 409 ai_not_configured, AI 작업을 다 쓴 워크스페이스는 429 ai_quota_exceeded입니다. 어느 경우에도 아무것도 만들어지지 않습니다.