Skip to content

SMSBAT API

SMSBAT Viber carousel, Viber राय संवाद, Viber प्रोमो (तस्बिर, भिडियो), Viber व्यापार च्याट, OTP सूचनाहरू (Viber OTP, फ्ल्यास कल) र तिनीहरूको फलब्याक भेरियन्टहरू सहित विभिन्न प्रकारका सन्देशहरू पठाउनको लागि एक RESTful API प्लेटफर्म हो।

आधार URL

SMSBAT API लाई अनुरोधहरू स्थानीयकरणको साथ अन्त बिन्दुमा पठाइन्छ। पहिले नै आफ्नो प्रबन्धकबाट ठेगाना अनुरोध गर्नुहोस्।

उदाहरण: https://restapi.smsbat.com (वास्तविक URL तपाईंको क्षेत्रको आधारमा फरक हुन सक्छ)

प्रमाणीकरण

SMSBAT API ले तीन प्रमाणीकरण विधिहरूलाई समर्थन गर्दछ:

विधि १: HTTP आधारभूत प्रमाणीकरण

आफ्नो प्रयोगकर्ता नाम र पासवर्ड प्रमाणहरू प्रयोग गर्नुहोस्:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

विधि २: API कुञ्जी हेडर

'X-Authorization-Key' हेडर प्रयोग गर्नुहोस्:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

विधि ३: पासवर्डको रूपमा API कुञ्जी

प्रयोगकर्ता नामको रूपमा @ र पासवर्डको रूपमा तपाइँको API कुञ्जी प्रयोग गर्नुहोस्:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

उपलब्ध समापन बिन्दुहरू

विधि अन्तिम बिन्दु विवरण
पोस्ट /bat/messagelist सन्देश पठाउनुहोस्
प्राप्त गर्नुहोस् /bat/message/{messageId} सन्देश स्थिति जाँच गर्नुहोस्

सन्देशका प्रकारहरू

SMSBAT API ले निम्न सन्देश प्रकारहरूलाई समर्थन गर्दछ:

  • SMS - मानक पाठ सन्देशहरू
  • भाइबर प्रोमो - रिच मिडिया संग प्रचार सन्देशहरू
  • भाइबर लेनदेन - लेनदेन सूचनाहरू
  • Viber Carousel - अन्तर्क्रियात्मक क्यारोसेल सन्देशहरू
  • भाइबर सर्वेक्षण - राय संवाद सन्देशहरू
  • Viber OTP - एक पटकको पासवर्ड सूचनाहरू
  • RCS - रिच कम्युनिकेशन सेवा सन्देशहरू
  • फ्लैश कल - मौन कल प्रमाणिकरण

मुख्य विशेषताहरू

फलब्याक सन्देश

जब प्राथमिक डेलिभरी असफल हुन्छ, SMSBAT स्वतः वैकल्पिक च्यानलहरूमा फर्कन्छ:

Viber → SMS → Email

रिच मिडिया समर्थन

यसका साथ सन्देशहरू पठाउनुहोस्:

  • छविहरू (JPG, PNG)
  • भिडियोहरू (MP4)
  • PDF हरू
  • बटन र कार्य लिङ्कहरू

सन्देश स्थिति ट्र्याकिङ

वास्तविक समयमा वितरण स्थिति ट्र्याक गर्नुहोस्:

  • पठाइयो
  • वितरण गरियो
  • पढ्नुहोस्
  • असफल
  • म्याद सकियो

कलब्याकहरू

दुई-तर्फी सञ्चारको लागि आगमन भाइबर सन्देश कलब्याकहरू प्राप्त गर्नुहोस्।

द्रुत सुरुवात

  1. एक सन्देश पठाउनुहोस् - आफ्नो पहिलो सन्देश कसरी पठाउने जान्नुहोस्
  2. स्थिति जाँच गर्नुहोस् - सन्देश डेलिभरी स्थिति ट्र्याक गर्नुहोस्
  3. सन्देशका प्रकारहरू - विभिन्न सन्देश प्रकारहरू अन्वेषण गर्नुहोस्

अनुरोध ढाँचा

सबै अनुरोधहरूले निम्न संरचनाको साथ JSON ढाँचा प्रयोग गर्छन्:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

प्रतिक्रिया ढाँचा

सफल प्रतिक्रियाहरू फिर्ता:

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

त्रुटि ह्यान्डलिंग

HTTP स्थिति कोडहरू:

  • `२०० ठीक छ' - अनुरोध सफल भयो
  • `400 खराब अनुरोध' - अमान्य अनुरोध ढाँचा
  • ४०१ अनाधिकृत - प्रमाणीकरण असफल भयो
  • `429 धेरै अनुरोधहरू' - दर सीमा नाघ्यो
  • ५०० आन्तरिक सर्भर त्रुटि - सर्भर त्रुटि

अर्को चरणहरू