← 全部范例范例 04
一次调用构建一份已核验的潜客名单
你将构建： 一份符合你筛选条件的公司中的人员核验名单，使用服务端的 lead-list 工作流 —— 先报价、再运行、然后导出为 CSV。
| 分类 | 服务端工作流 |
|---|---|
| 使用的操作 | POST /v1/data/workflows/lead-list:estimatePOST /v1/data/workflows/lead-list |
| 积分 | 7 每 位找到的人 (最坏情况) |
| 测试密钥可用 | 否 —— 需要正式密钥 |
| 预计耗时 | ~15 分钟 |
| 前置条件 | 一把有积分余额的 qk_live_ 密钥。本范例会触及付费来源，因此测试密钥返回的是固定样本数据而非实时结果。 |
这个工作流串联了什么
每个人在我们这边执行三步：按你的筛选条件找出候选人、找到邮箱地址、再核验该地址。你发送一次请求而不必自行编排三次，而且每一步只在产出结果时才计费。
list-workflows.sh
# Discover what is available to your key rather than
# trusting a list copied from a page.
curl https://api.qannasapi.com/v1/data/workflows \
-H "Authorization: Bearer $QANNAS_API_KEY"用 dry_run 报价
带 dry_run: true 发送工作流请求体，就能拿到逐步的积分明细而不会真正执行。这就是你该用来做预算的数字 —— 它假设每个人的每一步都成功。
quote.sh
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputs": {"industry": "logistics", "country": "AE"},
"limit": 25,
"dry_run": true
}'
# < X-Credits-Charged: 0 # the quote is free运行它
去掉 dry_run，发送同一个请求体。如果你要的是文件而非 JSON，把 format 设为 csv；markdown 同样可用。响应携带与其他调用相同的积分响应头，因此可以立即用运行结果对账报价。
run.sh
# Same body, without dry_run. format: json | csv | markdown
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputs": {"industry": "logistics", "country": "AE"},
"limit": 25,
"format": "csv"
}'
# < X-Credits-Charged: 138 # reconcile this against the quote按增量刷新
首次运行时设置 track_delta，下次把返回的游标作为 since_cursor 传入，即可只接收发生变化的部分。请注意：增量是对你所接收内容的过滤，而不是对你所支付金额的折扣。
delta.sh
# Run one: ask for a cursor.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-d '{"query": "logistics AE", "track_delta": true}'
# Run two: receive only what changed.
# NOTE: delta filters what you RECEIVE. It is not a discount.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-d '{"query": "logistics AE", "since_cursor": "cur_..."}'小结
| 模式 | 做法 |
|---|---|
| 报价 | POST /v1/data/workflows/lead-list，带 dry_run: true |
| 运行 | 同一个请求体，去掉 dry_run |
| 串联步骤 | 搜索 → 找邮箱 → 核验，按步计费 |
| 输出格式 | format: json | csv | markdown |
| 增量刷新 | 首次运行用 track_delta，之后用 since_cursor |
| 成本形态 | 按找到的人计费，而非按请求的人数 |
上线检查清单
- 每次定时运行前都用 dry_run 报价，而不只是第一次。
- 按上限做预算；按 X-Credits-Charged 对账。
- 把增量游标与名单一起存储，而不是放在应用内存里。
- 定期重新核验地址 —— 可送达性会衰减。
下一步
先运行预估。它不花任何费用，用的正是计量器将要套用的那套算术。