রেফারেন্স
API ত্রুটি এবং ত্রুটি কোড
ত্রুটিগুলি HTTP স্ট্যাটাস কোড ব্যবহার করে এবং সর্বদা একই JSON বডি থাকে। param ফিল্ডের নাম দেয় যখন একটি ফিল্ড কারণ হয়। প্রতিটি উত্তরে একটি X-Request-Id হেডার থাকে: একটি সাপোর্ট টিকেটে এটি উদ্ধৃত করুন।
{
"error": {
"code": "text_too_long",
"message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
"param": "text",
"doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
}
}কোড
| code | HTTP | কারণ | টাকা |
|---|---|---|---|
| invalid_json | 400 | বডিটি একটি JSON অবজেক্ট নয়, অথবা Content-Type application/json নয়। | বডিটি ঠিক করুন। কোনো চার্জ করা হয়নি। |
| invalid_request | 400 | একটি ফিল্ড অনুপস্থিত বা ভুল টাইপের; প্যারামিটারটি এর নাম বলে দেয়। | ফিল্ডটি ঠিক করুন। কোনো চার্জ করা হয়নি। |
| invalid_number | 400 | রিকোয়েস্টে কোনো নম্বর E.164 ফরম্যাটে পড়া যায়নি (+ এবং 7 থেকে 15 ডিজিট)। | নম্বরগুলো চেক করুন। কোনো চার্জ করা হয়নি। |
| unsupported_country | 400 / 404 | কোনো প্রাইসড কান্ট্রি নম্বরগুলোর সাথে মেলে না, অথবা GET /v1/pricing/{country} এ একটি অজানা কোড আছে। | কান্ট্রি লিস্ট চেক করুন। কোনো চার্জ করা হয়নি। |
| text_too_long | 400 | টেক্সটের জন্য 10টির বেশি সেগমেন্ট প্রয়োজন। | টেক্সট ছোট করুন। কোনো চার্জ করা হয়নি। |
| too_many_recipients | 400 | একটি রিকোয়েস্টে 10,000 এর বেশি রিসিপিয়েন্ট। | লিস্টটি ভাগ করুন। কোনো চার্জ করা হয়নি। |
| schedule_out_of_range | 400 | send_at একটি বৈধ সময় নয় (বর্তমান থেকে 2 মিনিট থেকে 45 দিনের মধ্যে হতে হবে)। | অন্য একটি সময় পিক করুন। কোনো চার্জ করা হয়নি। |
| suppressed | 400 | রিকোয়েস্টের প্রতিটি নম্বর আপনার do-not-send লিস্টে আছে (কনসোলে সেটিংসে)। | কিছুই পাঠানো বা চার্জ করা হয়নি। |
| unauthorized | 401 | Authorization হেডার অনুপস্থিত, ভুল ফরম্যাটের, অথবা কীটি রিভোক করা হয়েছে। | একটি লাইভ কী পাঠান। কোনো চার্জ করা হয়নি। |
| top_up_required | 402 | ব্যালেন্স রিকোয়েস্টের খরচের চেয়ে কম; মেসেজে উভয় অ্যামাউন্ট বলা আছে। | টপ আপ করে আবার পাঠান। কোনো চার্জ করা হয়নি। |
| not_found | 404 | এই অ্যাকাউন্টে id টি নেই, অথবা endpoint টি নেই। | id এবং পাথ চেক করুন। |
| idempotency_conflict | 409 | Idempotency-Key গত 24 ঘণ্টায় একটি ভিন্ন রিকোয়েস্ট বডির সাথে ব্যবহৃত হয়েছে। | নতুন রিকোয়েস্টের জন্য একটি নতুন কী ব্যবহার করুন। |
| not_cancelable | 409 | শুধুমাত্র একটি শিডিউল্ড ব্যাচ ক্যানসেল করা যায়; এটি ইতিমধ্যে শুরু বা শেষ হয়ে গেছে। | কিছুই পরিবর্তন হয়নি। |
| rate_limited | 429 | কীটি গত 60 সেকেন্ডে 600টির বেশি রিকোয়েস্ট করেছে। | Retry-After সেকেন্ড অপেক্ষা করুন। কোনো চার্জ করা হয়নি। |
| server_error | 500 | আমাদের পাশে কিছু ব্যর্থ হয়েছে। | একই Idempotency-Key দিয়ে আবার চেষ্টা করুন। |
পুনরায় চেষ্টা করা হচ্ছে
- 429 ছাড়া অন্য 4xx এরর হলে রিকোয়েস্টে পরিবর্তন দরকার; একই রিকোয়েস্ট আবার পাঠালে একই এরর আসবে।
- 429 এরর হলে Retry-After-এ উল্লিখিত সেকেন্ড সংখ্যা অপেক্ষা করুন।
- 5xx বা নেটওয়ার্ক টাইমআউট হলে একই Idempotency-Key দিয়ে রিট্রাই করুন: প্রথম রিকোয়েস্ট গ্রহণ করা হলে, দ্বিতীয় বার পাঠানোর বদলে প্রথম উত্তর ফেরত পাবেন।