curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
العملاء المحتملون والنماذج
سرد استجابات النموذج
GET /forms//responses/
GET
/
forms
/
{form_id}
/
responses
/
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
يسرد الإرساليات (“الاستجابات”) التي جمعها نموذج.
تُستبعَد دائمًا الإرساليات المتخطاة/غير المكتملة من هذه القائمة. يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ENTRY_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
form_id للنموذج.string
يصفّي الاستجابات المُرسَلة عبر رمز QR محدد، حسب
qrid.string
الاستجابات التي أُنشئت في هذا التاريخ أو بعده فقط (
YYYY-MM-DD).string
الاستجابات التي أُنشئت في هذا التاريخ أو قبله فقط (
YYYY-MM-DD).string
بحث عن سلسلة فرعية عبر الإجابات المُرسَلة واسم رمز QR المرتبط.
string
created أو -created. القيمة الافتراضية هي -created.integer
رقم الصفحة.
integer
عدد النتائج لكل صفحة، حتى 200. الافتراضي 20.
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
404 إذا لم يكن form_id يملكه هذا الحساب.
إذا تم تحويل هذا النموذج من قائمة عملاء محتملين قديمة، فإن الاستجابات التي تم جمعها قبل التحويل تُدمَج بشكل شفاف في هذه القائمة نفسها — يمكن أن تأتي معرّفات الاستجابة في تلك الحالة إما من مخزن استجابات النموذج الحالي أو من مخزن إدخالات العملاء المحتملين القديم، لكن الشكل المُعاد يكون متطابقًا في كلتا الحالتين.
ذو صلة
- حذف استجابة نموذج — إزالة استجابة واحدة.
- حذف استجابات النموذج دفعة واحدة — إزالة عدة استجابات دفعة واحدة.
- تصدير استجابات النموذج — تنزيل الاستجابات كملف CSV/XLSX.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
200
Paginated list of form submissions.
هل كانت هذه الصفحة مفيدة؟