مستندات Partner API

احراز هویت با هدر Authorization: Bearer lyk_live_.... درخواست‌های POST می‌توانند Idempotency-Key داشته باشند.

Swagger همین مسیرها

# ورک‌اسپیس
curl -X POST https://leadsys.duckdns.org/v1/workspaces \
  -H "Authorization: Bearer lyk_live_xxx" \
  -H "Idempotency-Key: ws-1" \
  -H "Content-Type: application/json" \
  -d '{"name":"shop-a","credit_cap":1000}'

# جستجوی شبکه اجتماعی
curl -X POST https://leadsys.duckdns.org/v1/searches \
  -H "Authorization: Bearer lyk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"source":"social","account":"digikalacom","limit":5}'

# لیست لیدها (CSV)
curl -H "Authorization: Bearer lyk_live_xxx" \
  "https://leadsys.duckdns.org/v1/leads?format=csv"

# وب‌هوک
curl -X POST https://leadsys.duckdns.org/v1/webhooks \
  -H "Authorization: Bearer lyk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://crm.example.com/hooks"}'

رویدادهای وب‌هوک: job.completed و lead.created. امضا در هدر X-Leadyar-Signature است (HMAC-SHA256 روی بدنه).

کردیت به ازای هر لید تحویل‌شده کسر می‌شود. سقف credit_cap روی هر ورک‌اسپیس اعمال می‌شود.