تغيير تصميم نموذج
يطبّق المصمِّم تعليمات مكتوبة على مسودة نموذج ويترك الباقي كما هو، كما يفعل «اسأل الذكاء الاصطناعي» في منشئ النماذج في التطبيق.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
POST /forms/{id}/redesign
يطبّق المصمِّم تعليمات مكتوبة على مسودة نموذج ويترك الباقي كما هو، كما يفعل «اسأل الذكاء الاصطناعي» في منشئ النماذج في التطبيق.
مثال
يتطلب forms:write. يذكر instructions ما يجب تغييره، حتى 4,000 حرف: إضافة الحقول أو إزالتها أو إعادة ترتيبها، وإعادة كتابة النصوص أو ترجمتها، وتغيير الألوان أو الخطوط.
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. ويُرفض بالطريقة نفسها الحفظ الذي يجري بينما يعمل المصمِّم، ولا يُكتب شيء.
يستهلك إجراء ذكاء اصطناعي واحدًا وقد يستغرق نصف دقيقة، ويفشل بالطرق نفسها التي يفشل بها تصميم نموذج.