پرش به مستندات
API

تغییر طراحی یک فرم

طراح دستورهای نوشته‌شده را روی پیش‌نویس یک فرم اعمال می‌کند و بقیه را دست نمی‌زند، همان‌طور که «از هوش مصنوعی بپرسید» در فرم‌ساز برنامه این کار را می‌کند.

POST/forms/{id}/redesign

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /forms/{id}/redesign

طراح دستورهای نوشته‌شده را روی پیش‌نویس یک فرم اعمال می‌کند و بقیه را دست نمی‌زند، همان‌طور که «از هوش مصنوعی بپرسید» در فرم‌ساز برنامه این کار را می‌کند.

نمونه

به forms:write نیاز دارد. instructions می‌گوید چه چیزی تغییر کند، تا 4,000 نویسه: افزودن، برداشتن یا جابه‌جا کردن فیلدها، بازنویسی یا ترجمهٔ متن‌ها، تغییر رنگ‌ها یا قلم‌ها.

curl
curl -X POST "$OE/forms/frm_3b9d2e7a1c4f80d56e2a9b14/redesign" -H "$AUTH" -H 'content-type: application/json' -d '{  "instructions": "Add a required company field after the name, and make the button say Join.",  "expectedUpdatedAt": "2026-09-30T09:12:44.000Z"}'
پاسخ
{  "object": "form",  "id": "frm_3b9d2e7a1c4f80d56e2a9b14",  "name": "Newsletter sign-up",  "status": "live",  "hasUnpublishedChanges": true,  "design": {    "notes": ["Added a required company field after the name.", "Changed the button to say Join."]  }}

تغییر در پیش‌نویس ذخیره می‌شود، بنابراین فرم منتشرشده تا POST /forms/{id}/publish همچنان نسخهٔ منتشرشده‌اش را نشان می‌دهد.

updatedAt را که خواندید به‌صورت expectedUpdatedAt بفرستید تا ذخیره‌ای که در این میان انجام شده با 409 version_conflict رد شود. ذخیره‌ای که هنگام کار طراح انجام شود هم به همین شکل رد می‌شود و چیزی نوشته نمی‌شود.

یک کنش هوش مصنوعی مصرف می‌کند، ممکن است تا نیم دقیقه طول بکشد و به همان شکل‌هایی شکست می‌خورد که طراحی یک فرم.

مرجع