ابنِ قائمة عملاء محتملين مُتحقَّقة باستدعاء واحد
ما ستبنيه: قائمة مُتحقَّقة بأشخاص في شركات تطابق مرشحاتك، عبر سير عمل lead-list على الخادم — مُسعَّرة أولًا، ثم مُشغَّلة، ثم مُصدَّرة كـ CSV.
| القسم | سير العمل على الخادم |
|---|---|
| الإجراءات المستخدمة | POST /v1/data/workflows/lead-list:estimatePOST /v1/data/workflows/lead-list |
| الائتمانات | 7 لكل شخص يُعثر عليه (أسوأ الحالات) |
| آمن مع مفتاح الاختبار | لا — يحتاج مفتاحًا فعليًا |
| مدة الإنجاز | ~15 دقيقة |
| المتطلبات | مفتاح qk_live_ برصيد ائتماني. هذه الوصفة تلامس مصادر مدفوعة، لذا يعيد مفتاح الاختبار بيانات ثابتة بدل نتائج حية. |
ما الذي يسلسله سير العمل
ثلاث خطوات تعمل لدينا لكل شخص: العثور على مرشحين يطابقون مرشحاتك، ثم العثور على عنوان البريد، ثم التحقق من ذلك العنوان. ترسل طلبًا واحدًا بدل تنسيق ثلاثة، وكل خطوة تُحاسَب فقط حين تنتج شيئًا.
# 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 فتحصل على تفصيل الائتمان لكل خطوة دون تشغيل أي شيء. هذا هو الرقم الذي تضع ميزانيتك عليه — فهو يفترض نجاح كل خطوة لكل شخص.
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 وأرسل الجسم نفسه. اضبط format على csv إن أردت ملفًا بدل JSON؛ و markdown متاح أيضًا. تحمل الاستجابة ترويسات الائتمان نفسها كأي استدعاء آخر، فتستطيع تسوية التشغيل مع العرض فورًا.
# 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 في التالي لتستقبل ما تغيّر فقط. لاحظ أن الفروق مرشِّح لما تستقبله، لا خصم على ما تدفعه.
# 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.
- خزِّن مؤشر الفروق مع القائمة، لا في ذاكرة التطبيق.
- أعد التحقق من العناوين دوريًا — قابلية التسليم تتآكل.
الخطوات التالية
شغِّل التقدير أولًا. لا يكلف شيئًا، وهو الحساب نفسه الذي سيطبقه العدّاد.