curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
واجهة الإدارة — العملاء المحتملون والنماذج
سرد النماذج
GET /forms/
GET
/
forms
/
curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
النماذج (Forms) هي أداة بناء التقاط العملاء المحتملين وجمع البيانات الحالية في Scanova — أكثر ثراءً من ميزة قوائم العملاء المحتملين القديمة، والطريقة الموصى بها لجمع بيانات الزوار من مسح رمز QR. اسردها أو أنشئها هنا.
يتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
count، results[0] هنا تعكس استجابة حقيقية تم التحقق منها مقابل حساب اختباري بنموذجين.
boolean
تصفية حسب النماذج الفعّالة أو غير الفعّالة.
string
الحد الأدنى الشامل (
YYYY-MM-DD) لـ created.string
الحد الأعلى الشامل (
YYYY-MM-DD) لـ created.string
مطابقة جزء نصي مقابل اسم النموذج.
string
created أو name، أيٌّ منهما مسبوق بـ - للترتيب التنازلي.حقول الاستجابة (لكل عنصر)
integer
string
معرّف النموذج الثابت، يُستخدم في رابط النموذج العام وكمعلمة مسار في نقطة نهاية الاسترجاع/التحديث/الحذف.
string
string | null
الاسم المعروض لمن أنشأ النموذج.
string
الرابط العام حيث يُعرض النموذج.
boolean
integer
عدد رموز QR المرتبطة حاليًا بهذا النموذج.
array
رموز QR المرتبطة بهذا النموذج، كل واحد بحقوله
qr_code__* الخاصة بالرمز المرتبط ورابطه القصير المحلول.integer | null
إجمالي الإرسالات المستلَمة.
null إذا تعذّر احتسابه (مثلًا عندما تعذّر الوصول إلى مخزن التتبع عبر قواعد البيانات).number | null
النسبة المئوية لعمليات المسح عبر رموز QR المرتبطة التي أسفرت عن إرسال.
null إذا لم تحدث أي عملية مسح بعد.string
string
ذات صلة
- إنشاء نموذج — العملية الأخرى لنفس نقطة النهاية هذه.
- إدارة قوائم العملاء المحتملين — ميزة التقاط العملاء المحتملين القديمة التي تحل محلها النماذج (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.
الاستجابة
200
List of forms
هل كانت هذه الصفحة مفيدة؟
⌘I