قیمت‌گذاری و حذف هوشمند تکرار

مدل قیمت‌گذاری در سطح فیلد

هر فیلد قابل خرید (phone، email، owner_name، owner_national_id) قیمت مستقل دارد. هنگام فراخوانی leads/get-records/ شما در requested_fields مشخص می‌کنید کدام فیلدها را می‌خواهید و فقط برای همان‌ها هزینه می‌پردازید.

حذف خودکار تکرار

هر سه‌تایی منحصر به فرد (API-key-owner, lead_id, field) فقط یک‌بار قیمت‌گذاری می‌شود. در فراخوانی‌های بعدی همان فیلد برای همان سرنخ، مقدار از حافظه برگردانده می‌شود و total_charged برابر صفر است.

مثال عملی

1. فراخوانی اول: درخواست phone برای lead_id=9001

   json

   کپی

   // response
   {
     "debit_transaction_id": 90142,
     "total_charged": "5000",
     "results": [
       { "lead_id": 9001, "lead_type": "phonenumber", "lead_data": "+98912…", "phone": "+98912…" }
     ]
   }

2. فراخوانی دوم (همان کلید): درخواست phone برای lead_id=9001 — رایگان

   json

   کپی

   // response — تکرار همان ترکیب
   {
     "debit_transaction_id": 90143,
     "total_charged": "0",
     "results": [
       { "lead_id": 9001, "lead_type": "phonenumber", "lead_data": "+98912…", "phone": "+98912…" }
     ]
   }

3. فراخوانی سوم (همان کلید): درخواست email برای lead_id=9001 — فقط email قیمت‌گذاری می‌شود

   json

   کپی

   // response — phone قبلاً خریده شده، فقط email قیمت می‌خورد
   {
     "debit_transaction_id": 90144,
     "total_charged": "5000",
     "results": [
       {
         "lead_id": 9001,
         "lead_type": "phonenumber",
         "lead_data": "+98912…",
         "phone": "+98912…",
         "email": "user@example.com"
       }
     ]
   }