WO SMS — API Documentation

Overview

এই ডকুমেন্টে WO SMS প্লাগিন যে API কল করে তার পূর্ণ বিবরণ দেওয়া আছে — যাতে SMS প্যানেল ঠিকভাবে রেসপন্স দিতে পারে।

গেটওয়ে সবসময় HTTP 200 ফেরত দেয় — আসল ফলাফল থাকে JSON body-র statusCode / status ফিল্ডে।

Base URL

1 Send SMS

Headers

Content-Type: application/json
Accept: application/json

Request Body (JSON)

{
  "UserName": "your_username",
  "Apikey": "your_api_key",
  "MobileNumber": "8801712345678",
  "CampaignId": "null",
  "SenderName": "CODEFORHOST",
  "TransactionType": "T",
  "Message": "প্রিয় গ্রাহক, আপনার অর্ডার কনফার্ম হয়েছে।"
}

Parameters

cURL উদাহরণ

# Send SMS
curl -X POST "https://smsapi.resellcore.com/api/SmsSending/SMS" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "UserName": "your_username",
    "Apikey": "your_api_key",
    "MobileNumber": "8801712345678",
    "CampaignId": "null",
    "SenderName": "CODEFORHOST",
    "TransactionType": "T",
    "Message": "Test message"
  }'

Success Response (HTTP 200)

{
  "statusCode": "200",
  "status": "Success",
  "responseResult": "SMS Submitted Successfully"
}

❌ Error Response (HTTP 200, ভিন্ন statusCode)

{
  "statusCode": "406",
  "status": "Failed",
  "responseResult": "IP Black List."
}

2 Balance Check

Request Body (JSON)

{
  "UserName": "your_username",
  "Apikey": "your_api_key"
}

cURL উদাহরণ

curl -X POST "https://smsapi.resellcore.com/api/SmsSending/balanceCheck" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "UserName": "your_username", "Apikey": "your_api_key" }'

Success Response (HTTP 200)

{
  "statusCode": "200",
  "status": "Success",
  "responseResult": "1375.33"
}

প্লাগিন responseResult-কে ব্যালেন্স হিসেবে পড়ে এবং ৳1,375.33 ফরম্যাটে দেখায়। balance / Balance / current_balance কী থাকলেও ধরতে পারে।

Response ব্যাখ্যা

গেটওয়ে সবসময় HTTP 200 দেয়। প্লাগিন এভাবে success/fail নির্ণয় করে:

success = (HTTP 2xx)
          AND ( statusCode == "200"
                OR status ∈ { "Success", "Sent", "Delivered" } )

Field নাম case-insensitive সহনশীল: statusCode/StatusCode, status/Status, responseResult/ResponseResult — যেকোনোটি চলবে।

নম্বর ফরম্যাট, Signature ও IP Whitelist

মোবাইল নম্বর ফরম্যাট

Signature

Settings-এ Signature সেট থাকলে (যেমন -YourBrand) প্রতিটি Message-এর শেষে যোগ হয় (আগে থেকে থাকলে দুবার যোগ হয় না)। খালি রাখলে কিছু যোগ হয় না।

IP Whitelist

API IP Black List. দিলে সার্ভারের আউটগোয়িং IP প্যানেলে যোগ করতে হবে। প্লাগিন IPv6 ঝামেলা এড়াতে অনুরোধ IPv4-তে pin করে রাখে।

(ঐচ্ছিক) GET query-string বিকল্প

প্লাগিন POST JSON ব্যবহার করে। অনেক প্যানেল সমতুল্য GET রিকোয়েস্টও গ্রহণ করে — শুধু রেফারেন্সের জন্য:

# সব প্যারামিটার query string-এ
?UserName=your_username
&Apikey=your_api_key
&MobileNumber=8801712345678
&SenderName=CODEFORHOST
&TransactionType=T
&Message=Test%20message

সারসংক্ষেপ