curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
العملاء المحتملون والنماذج
تصدير استجابات النموذج
POST /forms/export/
POST
/
forms
/
export
/
curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
يُنزِّل استجابات النموذج كملف CSV أو Excel — إما لنموذج واحد، أو عبر جميع النماذج المرتبطة بمجموعة من رموز QR.
الاستجابة هي تنزيل ملف (
يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ENTRY_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
يصدّر استجابات نموذج واحد، مع مخطط أسئلته الخاص كعناوين للأعمدة. يستبعد
qr_ids بشكل متبادل.array
يصدّر الاستجابات عبر كل نموذج (وقائمة عملاء محتملين محوَّلة) مرتبط بمعرّفات
qrid هذه — تُدمَج الأسئلة من نماذج متعددة في أعمدة مجمَّعة. يستبعد form_id بشكل متبادل.string
افتراضي:"xls"
csv أو xls أو xlsx.string
الاستجابات التي أُنشئت في هذا التاريخ أو بعده فقط (
YYYY-MM-DD).string
الاستجابات التي أُنشئت في هذا التاريخ أو قبله فقط (
YYYY-MM-DD).curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
Content-Type: text/csv، أو نوع MIME الخاص بـ XLS/XLSX)، وليست JSON، مع Content-Disposition: attachment. الأعمدة هي Tracking ID, QR Code, Created, Skip, Source، عمود واحد لكل سؤال، ثم ثمانية أعمدة ختامية للتتبع: Scan Time, Scan Day, Device Type, City, Country Code, Country Name, Postal Code, Region.
يُعاد 400 إذا قُدِّم كل من form_id وqr_ids، أو لم يُقدَّم أي منهما:
400
{ "detail": "form_id and qr_ids are mutually exclusive" }
400
{ "detail": "Either form_id or qr_ids is required" }
400 إذا لم يكن file_format واحدًا من csv أو xls أو xlsx:
400
{ "detail": "Unknown file format" }
ذو صلة
- سرد استجابات النموذج — المكافئ بصيغة JSON لنموذج واحد، مع الفلاتر.
- الحصول على تحليلات النموذج — أرقام مجمَّعة بدلاً من صفوف خام.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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.
الاستجابة
200
CSV or XLSX file download.
هل كانت هذه الصفحة مفيدة؟