Skip to main content
GET
النماذج (Forms) هي أداة بناء التقاط العملاء المحتملين وجمع البيانات الحالية في Scanova — أكثر ثراءً من ميزة قوائم العملاء المحتملين القديمة، والطريقة الموصى بها لجمع بيانات الزوار من مسح رمز QR. اسردها أو أنشئها هنا.
يتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.
count، results[0] هنا تعكس استجابة حقيقية تم التحقق منها مقابل حساب اختباري بنموذجين.
boolean
تصفية حسب النماذج الفعّالة أو غير الفعّالة.
string
الحد الأدنى الشامل (YYYY-MM-DD) لـ created.
string
الحد الأعلى الشامل (YYYY-MM-DD) لـ created.
مطابقة جزء نصي مقابل اسم النموذج.
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

ذات صلة

التفويضات

Authorization
string
header
مطلوب

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