Skip to main content
GET
将潜在客户列表的条目下载为 CSV 或 Excel 文件。
需要具有 MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额和 LEAD_GENERATION_ENTRY_CAN_VIEW 权限的管理 API 密钥,作为原始 Authorization 标头值发送 —— 参见管理 API 概述
string
必填
潜在客户列表的 lead_id
string
默认值:"csv"
csvxlsxlsx
string
仅包含在此日期(含)之后创建的条目(YYYY-MM-DD)。
string
仅包含在此日期(含)之前创建的条目(YYYY-MM-DD)。
string
以逗号分隔的条目 UUID,用于将导出范围限定为特定选择 —— 对应仪表板的”下载所选项”操作。无效的 UUID 会被静默忽略而非报错。
列出潜在客户条目相同的子字符串搜索 —— 对应”下载筛选结果”。
响应是文件下载(Content-Type: text/csv,或 xls/xlsx 对应的 XLSX MIME 类型),而非 JSON,带有 Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>
无论账户其他位置的追踪权限如何,导出文件始终包含 tracking_id 列。如果提交所用的 QR 码此后已被删除,其列值会渲染为 <qrid> (Deleted),而不会导致导出失败。当没有匹配的条目时,文件仍会包含一个表头行(源自潜在客户表单自身的问题标签),而不是为空。
在免费计划账户(plan_type 1)上,导出限制为 25 行 —— 如果匹配的条目超过此数,会在末尾附加两行说明达到限制并建议升级。
如果 file_format 不是 csvxlsxlsx 之一,则返回带纯文本正文(而非标准 DRF 错误格式)的 400
400

相关内容

授权

Authorization
string
header
必填

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.