নিরাপদ রিট্রাই
সংযোগ বিচ্ছিন্ন হলে আপনি জানতে পারেন না অর্ডারটি পৌঁছেছে কি না। তাই আবার পাঠান: 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"]}'আপনি যা ফেরত পান
201 এবং নতুন অর্ডার।200, একই অর্ডার, এবং Idempotent-Replay: true। আর কিছু চার্জ হয় না, এর মধ্যে দাম বদলে গেলেও।order_status_unknown বা rate_limited।409 idempotency_conflict। কোনো অর্ডার দেওয়া হয় না।insufficient_balance-এর মতো প্রত্যাখ্যানের পরে একই Idempotency-Key409 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 রাখুন।