रेफरेंस

API त्रुटियाँ और त्रुटि कोड

मार्कडाउन के रूप में देखें OpenAPI स्पेक

त्रुटियाँ HTTP स्टेटस कोड का उपयोग करती हैं और हमेशा एक ही JSON बॉडी होती है। param उस फील्ड का नाम बताता है जो कारण है। प्रत्येक उत्तर में X-Request-Id हेडर होता है: सपोर्ट टिकट में इसे उद्धृत करें।

400 Bad RequestJSON

{
  "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 इस अकाउंट में मौजूद नहीं है, या एंडपॉइंट मौजूद नहीं है।	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 के साथ पुनः प्रयास करें: यदि पहला अनुरोध स्वीकार कर लिया गया था, तो आपको दूसरी बार भेजने के बजाय उसका उत्तर वापस मिल जाएगा।

पिछलाप्राइसिंग API अगलारेट लिमिट