curl --request POST \
--url 'https://api.scanova.io/lead/analytics/export/?file_format=xlsx&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"] }' \
--output lead_analytics.xlsx
العملاء المحتملون والنماذج
تصدير تحليلات العملاء المحتملين
POST /lead/analytics/export/
POST
/
lead
/
analytics
/
export
/
curl --request POST \
--url 'https://api.scanova.io/lead/analytics/export/?file_format=xlsx&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"] }' \
--output lead_analytics.xlsx
يُنزِّل تحليلات العملاء المحتملين (جميع التفصيلات الثلاثة: أعداد الإدخالات والتحويل والمصدر) كملف.
الاستجابة هي تنزيل ملف —
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ANALYTICS_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.array
مطلوب
مثل الحصول على تحليلات العملاء المحتملين —
lead_ids أو url_hashes لرموز QR، حسب filter_by.string
افتراضي:"lead_id"
lead_id (الافتراضي) أو qr_hash.string
افتراضي:"csv"
csv (ملف ZIP يحتوي على CSV واحد لكل تفصيل)، أو xls/xlsx (مصنّف واحد بثلاث أوراق عمل).string
تاريخ البدء (
YYYY-MM-DD). القيمة الافتراضية هي 7 أيام قبل to.string
تاريخ الانتهاء (
YYYY-MM-DD). القيمة الافتراضية هي اليوم.curl --request POST \
--url 'https://api.scanova.io/lead/analytics/export/?file_format=xlsx&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"] }' \
--output lead_analytics.xlsx
application/zip مع Content-Disposition: attachment; filename=lead_analytics.zip لـ csv، أو نوع MIME الخاص بـ XLSX مع filename=lead_analytics.xlsx لـ xls/xlsx. على عكس الحصول على تحليلات العملاء المحتملين، لا يوجد فلتر type — يتضمن التصدير دائمًا جميع التفصيلات الثلاثة.
يُعاد 400 بنص عادي إذا لم يُتعرَّف على file_format:
400
{ "detail": "Invalid file format" }
ذو صلة
- الحصول على تحليلات العملاء المحتملين — المكافئ بصيغة JSON، مع فلتر
type. - نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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
ZIP of CSVs or a multi-sheet XLSX file download.
هل كانت هذه الصفحة مفيدة؟