curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "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": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+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
}
واجهة الإدارة — العملاء المحتملون والنماذج
إنشاء نموذج
POST /forms/
POST
/
forms
/
curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "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": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+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
}
النماذج (Forms) هي أداة بناء التقاط العملاء المحتملين وجمع البيانات الحالية في Scanova — أكثر ثراءً من ميزة قوائم العملاء المحتملين القديمة، والطريقة الموصى بها لجمع بيانات الزوار من مسح رمز QR. اسردها أو أنشئها هنا.
يتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "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": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+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
}
string
مطلوب
اسم النموذج.
object
مطلوب
مخطط حقول النموذج — يُتحقق من صحته مقابل مخطط JSON الخاص بمنشئ النماذج في Scanova. البيانات غير الصحيحة تعيد 400 تحت
data.string
qrid الخاص برمز QR لإرفاقه فورًا عند الإنشاء. ينطبق فقط على رموز QR الديناميكية (dy).integer
معرّف سمة (theme) فعّالة لتنسيق الصفحة العامة للنموذج. اتركها فارغة لاستخدام سمة المنصة الافتراضية.
object
تجاوزات جزئية لرموز السمة (theme tokens) تُطبَّق فوق
theme_id (أو السمة الافتراضية).ربط رموز QR إضافية بعد الإنشاء، أو استبدال مجموعة الروابط بالكامل، ليس جزءًا من نص طلب نقطة النهاية هذه — هذا إجراء منفصل لاستبدال الروابط
qr_ids متاح في لوحة التحكم/الـ API الداخلية، لكنه غير معروض هنا حاليًا.ذات صلة
- سرد النماذج — العملية الأخرى لنفس نقطة النهاية هذه.
- إدارة قوائم العملاء المحتملين — ميزة التقاط العملاء المحتملين القديمة التي تحل محلها النماذج (Forms).
- سرد / إنشاء رموز QR — ابحث عن
qridلتمريره كـqr_idعند إنشاء نموذج. - نظرة عامة على Management API — مخطط المصادقة وبنية الحصص التي تنتمي إليها نقطة النهاية هذه.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
201
Form created
هل كانت هذه الصفحة مفيدة؟
⌘I