شغّل كل أداة فحص من خادمك

كيف يعملCopy Anchor Link

1. 1

   أنشئ مفتاح API

   أنشئ مفتاح API في حسابك. يظهر مرة واحدة فقط، فاحفظه في مكان آمن.

2. 2

   احصل على تقدير

   أرسل قائمتك إلى POST /estimates لترى السعر وأي مشكلة فيها. لا يُخصم أي مبلغ.

3. 3

   قدّم الطلبية

   أرسل القائمة نفسها إلى POST /orders مع Idempotency-Key. يُخصم مبلغ الطلبية مرة واحدة، مهما كررت إرسالها.

4. 4

   اجلب النتيجة

   تحقق من GET /orders/{id} حتى تكتمل، ثم احصل على الملف من GET /orders/{id}/results.

بداية سريعةCopy Anchor Link

استبدل مفتاح API بمفتاحك. العنوان الأساسي هو https://api.talismanleads.io/v1، والطلبات والاستجابات بصيغة JSON.

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

من المفيد معرفتهCopy Anchor Link

• المبالغ دائمًا سلسلة نصية بالدولار الأمريكي، مثل "18.00".
• يُحتسب كل ملف على أساس 2,000 إدخال على الأقل، في API كما في الموقع.
• يمكن إرسال قائمة تصل إلى 100,000 إدخال و4 MB داخل الطلب. أما القائمة الأكبر، حتى 10,000,000 إدخال أو 200 MB، فتُرسل عبر POST /uploads.
• تحقق من حالة الطلبية كل 30 ثانية أو أكثر. تعتمد مدة الطلبية على حجمها وعلى أداة الفحص.
• اترك ما يصل إلى 5 دقائق لوصول الاستجابة من POST /estimates وPOST /orders: فقراءة القائمة الكبيرة تستغرق وقتًا. والمهلة الأقصر تجعلك تعيد الإرسال بلا فائدة.