curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
العملاء المحتملون والنماذج
تصدير إدخالات العملاء المحتملين
GET /lead//entry/export/
GET
/
lead
/
{lead_id}
/
entry
/
export
/
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
يُنزِّل إدخالات قائمة عملاء محتملين كملف CSV أو Excel.
الاستجابة هي تنزيل ملف (
يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ENTRY_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
lead_id لقائمة العملاء المحتملين.string
افتراضي:"csv"
csv أو xls أو xlsx.string
الإدخالات التي أُنشئت في هذا التاريخ أو بعده فقط (
YYYY-MM-DD).string
الإدخالات التي أُنشئت في هذا التاريخ أو قبله فقط (
YYYY-MM-DD).string
معرّفات UUID لإدخالات مفصولة بفواصل لقصر التصدير على تحديد معين — يعكس إجراء “تنزيل المحدد” في لوحة التحكم. تُتجاهل معرّفات UUID غير الصالحة بصمت بدلاً من رفضها.
string
نفس بحث السلسلة الفرعية الموجود في سرد إدخالات العملاء المحتملين — يعكس “تنزيل النتائج المصفّاة”.
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
Content-Type: text/csv، أو نوع MIME الخاص بـ XLSX لـ xls/xlsx)، وليست JSON، مع Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>.
يتضمن الملف المُصدَّر دائمًا عمود
tracking_id، بصرف النظر عن صلاحيات التتبع في أي مكان آخر بالحساب. إذا كان رمز QR المُرسِل قد حُذف منذ ذلك الحين، تُعرض قيمة عموده كـ <qrid> (Deleted) بدلاً من فشل التصدير. مع عدم وجود إدخالات مطابقة، لا يزال الملف يحتوي على صف عنوان (مُشتق من تسميات أسئلة نموذج العملاء المحتملين نفسه) بدلاً من أن يكون فارغًا.في حساب بخطة مجانية (
plan_type 1)، يُحدَّد التصدير بـ 25 صفًا — إذا كانت هناك إدخالات مطابقة أكثر، تُضاف صفّان ختاميّان يشيران إلى الحد ويدعوان إلى الترقية.400 بنص عادي (وليس شكل خطأ DRF القياسي) إذا لم يكن file_format واحدًا من csv أو xls أو xlsx:
400
{ "detail": "requested file format unknown" }
ذو صلة
- سرد إدخالات العملاء المحتملين — المكافئ بصيغة 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: 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
CSV or XLSX file download.
هل كانت هذه الصفحة مفيدة؟