curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
العملاء المحتملون والنماذج
الحصول على تحليلات النموذج لكل سؤال
GET /forms//analytics/questions/
GET
/
forms
/
{form_id}
/
analytics
/
questions
/
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
يعيد كيفية الإجابة عن كل سؤال في النموذج، بترتيب الأسئلة في النموذج نفسه: عدد الاستجابات التي أجابت عنه، والنسبة التي يمثّلها ذلك من الاستجابات، و— لأسئلة الاختيار والتقييم والمقياس — عدد مرات اختيار كل إجابة.
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ANALYTICS_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
form_id للنموذج.string
احتساب الاستجابات الواردة في هذا التاريخ أو بعده فقط (
YYYY-MM-DD).string
احتساب الاستجابات الواردة في هذا التاريخ أو قبله فقط (
YYYY-MM-DD).string
احتساب الاستجابات المُرسَلة عبر رمز QR هذا فقط (قيمة
qrid الخاصة به).curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
response_rateهي قيمةansweredكنسبة مئوية من استجابات النموذج خلال الفترة، مقرّبة إلى منزلة عشرية واحدة. الإرساليات التي تم تخطيها ليست استجابات ولا تُحتسب.- لا يظهر
distributionإلا لأسئلة الاختيار (multipleChoiceوcheckboxوdropdown)، والتقييمات (starRatingوemojiوlikeDislike)، والمقاييس (linearScaleوnumber). وفي أسئلة الاختيار تُدرَج كل الخيارات، بما فيها التي لم يخترها أحد، مرتّبةً من الأكثر اختيارًا. وتُحتسب استجابةcheckboxمرة واحدة لكل خيار حدّدته. - كتل المحتوى المخصّصة للعرض فقط ليست أسئلة ولا تظهر.
ذو صلة
- الحصول على تحليلات النموذج — إجماليات الاستجابات ومرات التخطي عبر الزمن، والاستجابات حسب المصدر.
- سرد استجابات النموذج — الإرساليات الفردية وراء هذه الأرقام.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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.
معلمات المسار
The form's form_id.
معلمات الاستعلام
Only responses on or after this date (YYYY-MM-DD).
Only responses on or before this date (YYYY-MM-DD).
Only responses submitted through this QR Code (qrid).
هل كانت هذه الصفحة مفيدة؟