सीधे कंटेंट पर जाएं
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। कोई ऑर्डर नहीं दिया जाता।
insufficient_balance जैसे अस्वीकार के बाद वही Idempotency-Key
उसे फिर से आज़माया जाता है, इसलिए टॉप-अप करने के बाद वह काम करता है, पहले बताई गई कीमत पर। अपलोड की गई फ़ाइल तब भी मौजूद होनी चाहिए: देखें ऑर्डर देना। अगर कीमत बदल गई है, तो आपको 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 रखें।

ऑर्डर देना

पिछला

रेट लिमिट

अगला

इस पेज पर

यह कैसे काम करता हैआपको क्या मिलता हैजब आपको पता न होIdempotency-Key कितने समय तक चलती है