ইডেম্পোটেন্ট রিকোয়েস্ট

নেটওয়ার্ক ব্যর্থ হয়। পাঠানোর রিকোয়েস্ট টাইমআউট হলে, গ্রহণ করা হয়েছিল কিনা জানা যাবে না। Idempotency-Key হেডারসহ POST /v1/messages ও POST /v1/batches পাঠান, এবং একই কী দিয়ে রিট্রাই করুন।

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-55102-shipped" \
  -d '{"to": "+14155550123", "text": "Order 55102 has shipped."}'

নিয়ম

• কী হলো 255 অক্ষরের যেকোনো স্ট্রিং। ইভেন্টের নাম দেয় এমন কিছু ব্যবহার করুন: অর্ডার আইডি ও ধাপ, বা প্রথম চেষ্টার আগে তৈরি করা একটি UUID।
• গ্রহণ করা রিকোয়েস্ট (202) অ্যাকাউন্টপ্রতি 24 ঘণ্টা মনে রাখা হয়। একই কী ও বডি প্রথম উত্তর আবার ফেরত দেবে, Idempotent-Replayed: true হেডারসহ, এবং কিছু পাঠাবে না।
• ভিন্ন বডিসহ একই কী 409 idempotency_conflict উত্তর দেবে।
• এররসহ ব্যর্থ রিকোয়েস্ট মনে রাখা হয় না, তাই সেগুলো ঠিক করে একই কী দিয়ে রিট্রাই করতে পারেন।