इडेम्पोटेंट अनुरोध

नेटवर्क विफल हो सकते हैं। यदि भेजने का अनुरोध टाइमआउट हो जाता है, तो आप यह नहीं जान सकते कि इसे स्वीकार किया गया था या नहीं। POST /v1/messages और POST /v1/batches को Idempotency-Key हेडर के साथ भेजें, और उसी कुंजी के साथ पुनः प्रयास करें।

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 होता है।
• त्रुटि के साथ विफल होने वाले अनुरोधों को याद नहीं रखा जाता है, इसलिए आप उन्हें ठीक कर सकते हैं और उसी कुंजी के साथ पुनः प्रयास कर सकते हैं।