انتقل إلى المحتوى
TalismanLeadsDocs
الرئيسيةاحصل على مفتاح API

إعادة المحاولة بأمان

عندما ينقطع الاتصال، لا يمكنك معرفة هل وصلت طلبيتك أم لا. لذا أرسلها مجددًا: طوال 7 أيام، يعني مفتاح Idempotency-Key نفسه الطلبية نفسها، ولا يُخصم مبلغها إلا مرة واحدة.

كيف يعمل

يتطلب POST /orders ترويسة Idempotency-Key: ما يصل إلى 200 حرف ASCII بلا مسافات، تنشئها بنفسك وتحفظها مع سجلك الخاص بالطلبية. ويفي UUID بالغرض. استخدم مفتاح Idempotency-Key جديدًا لكل طلبية جديدة.

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"]}'

ما تحصل عليه

مفتاح Idempotency-Key جديد
201 والطلبية الجديدة.
مفتاح Idempotency-Key نفسه والطلب نفسه مرة أخرى
200، والطلبية نفسها، وIdempotent-Replay: true. لا يُخصم أي مبلغ إضافي، حتى إذا تغيّر السعر منذ ذلك الحين.
مفتاح Idempotency-Key نفسه في اللحظة نفسها
طلبية واحدة وخصم واحد. تحصل على تلك الطلبية، أو على رفض يعني أن تعيد الإرسال بمفتاح Idempotency-Key نفسه، مثل order_status_unknown أو rate_limited.
مفتاح Idempotency-Key نفسه مع طلب مختلف
409 idempotency_conflict. لا تُقدَّم أي طلبية.
مفتاح Idempotency-Key نفسه بعد رفض مثل insufficient_balance
تُعاد المحاولة، فتنجح بعد أن تشحن رصيدك، بالسعر الذي حُدد أولًا. ويجب أن يظل الملف المرفوع موجودًا: راجع تقديم الطلبيات. إذا تغيّر السعر، تحصل على 409 price_changed، ويقدّم مفتاح Idempotency-Key جديد الطلبية بالسعر الجديد.

عندما لا تعرف

أي استجابة ضاعت، وorder_status_unknown، والاستجابة التي ليست JSON، مثل 502 أو 504 من بوابة، تعني كلها الأمر نفسه: أعد الطلب بمفتاح Idempotency-Key نفسه لتعرف الحالة الحقيقية. ولا يخصم ذلك مرتين أبدًا. لا تنشئ أبدًا مفتاح Idempotency-Key جديدًا بسبب انتهاء مهلة طلب أو فشله: فهذه طلبية جديدة، ويُخصم مبلغها.

انتظر دقيقة بين كل إعادة وأخرى. إذا استمرت الاستجابة order_status_unknown بعد بضع دقائق، فتوقف وتواصل مع الدعم مع ذكر request_id. لا تنشئ مفتاح Idempotency-Key جديدًا.

كم يدوم مفتاح Idempotency-Key

يُحفظ مفتاح Idempotency-Key لمدة 7 أيام من أول إرسال له. بعد ذلك يقدّم المفتاح نفسه طلبية جديدة، لذا أعد المحاولة خلال بضعة أيام، وخصص مفتاح Idempotency-Key جديدًا لكل طلبية جديدة.

تقديم الطلبيات

السابق

حدود المعدل

التالي

في هذه الصفحة

كيف يعملما تحصل عليهعندما لا تعرفكم يدوم مفتاح Idempotency-Key