curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
العملاء المحتملون والنماذج
تحديث نموذج
PATCH /forms//
PATCH
/
forms
/
{form_id}
/
curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
يحدّث اسم نموذج أو مخطط الحقول أو إعدادات السمة.
يُدعَم كل من
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_CAN_EDIT، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.PUT https://api.scanova.io/forms/{form_id}/
PATCH https://api.scanova.io/forms/{form_id}/
string
مطلوب
معرّف
form_id للنموذج. غير قابل للتغيير — لا يمكن تعديله عبر هذا الطرف.string
اسم النموذج.
object
مخطط حقول النموذج — يُعاد التحقق منه مقابل مخطط JSON الخاص بمنشئ النماذج في Scanova عند كل تحديث. تُعيد البيانات غير الصحيحة
400 تحت data.integer
معرّف سمة نشطة لتنسيق الصفحة العامة للنموذج.
object
تجاوزات جزئية لرموز السمة تُوضع فوق
theme_id (أو السمة الافتراضية).curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
PUT وPATCH. لا يقبل هذا الطرف qr_id/qr_ids — استخدم ربط رموز QR بنموذج لتغيير رموز QR المرفقة. يُعاد 404 إذا لم يكن form_id يملكه هذا الحساب.
ذو صلة
- جلب نموذج — عرض القيم الحالية قبل التحديث.
- ربط رموز QR بنموذج — تغيير رموز QR المرتبطة.
- حذف نموذج — إزالته نهائيًا.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
200
Form updated.
هل كانت هذه الصفحة مفيدة؟