API دریافت لید

با این API هر سامانهٔ بیرونی می‌تواند Lead جدید به لیدورا بفرستد. کلید API از بخش منابع لید در پنل ساخته می‌شود و به یک منبع مشخص گره خورده است.

۱. ساخت کلید API

در پنل لیدورا به تنظیمات منابع لید بروید، یک منبع بسازید (مثلاً «سایت اصلی»). کلید فقط همان لحظه یک‌بار نمایش داده می‌شود — همان‌جا کپی کنید.

۲. آدرس و احراز هویت

درخواست را با متد POST به مسیر زیر بفرستید (دامنه همان دامنهٔ سازمان شماست):

POST https://npkavir.lidora.ir/api/leads

کلید را در یکی از این دو هدر بگذارید:

Authorization: Bearer YOUR_API_KEY

# یا:
X-Api-Key: YOUR_API_KEY

بدون کلید معتبر پاسخ 401 است. برای هر سایت/لندینگ یک منبع و کلید جدا توصیه می‌شود.

۳. فیلدها

فیلدهای اضافه (مثل utm_source) رد نمی‌شوند؛ همراه کل payload روی لید ذخیره می‌شوند.

۴. نمونه curl

curl -X POST https://npkavir.lidora.ir/api/leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"علی رضایی","phone":"09121234567","email":"ali@example.com","message":"درخواست مشاوره"}'

۵. نمونه جاوااسکریپت

fetch("https://npkavir.lidora.ir/api/leads", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "علی رضایی",
    phone: "09121234567",
  }),
});

۶. وردپرس و فرم‌سازها

با افزونهٔ Webhook فرم‌ساز (مثلاً WPForms / Contact Form 7 + webhook):

• URL را روی endpoint بالا بگذارید
• متد POST و نوع محتوا JSON
• هدر Authorization: Bearer YOUR_API_KEY
• فیلدهای فرم را به name، phone، email نگاشت کنید

۷. پاسخ موفق

HTTP 201
{"success": true, "id": 123}

اعتبارسنجی ناموفق معمولاً 422 با پیام فارسی و جزئیات خطا برمی‌گرداند.