မက်ဆေ့ခ်ျပို့ပါ။

/bat/messagelist အဆုံးမှတ်ကို အသုံးပြု၍ SMSBAT API မှတဆင့် စာတိုပေးပို့ပါ။

အဆုံးမှတ်

POST /bat/messagelist

တောင်းဆိုဖွဲ့စည်းပုံ

တောင်းဆိုချက်ကိုယ်ထည်သည် မက်ဆေ့ဂျ်အရာများ၏ JSON အခင်းအကျင်းတစ်ခုဖြစ်သည်-

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

ကန့်သတ်ချက်များ

လိုအပ်သော ကန့်သတ်ချက်များ

ကန့်သတ်ချက်	ရိုက်	ဖော်ပြချက်
from	string	အက္ခရာဂဏန်း ပေးပို့သူ ID
to	string	လက်ခံသူဖုန်းနံပါတ် E.164 ဖော်မတ် (ဥပမာ၊ +380XXXXXXXXX)
ရိုက်	string	မက်ဆေ့ဂျ်အမျိုးအစား- sms၊ viber_promo၊ viber_trans၊ viber_carousel၊ viber_survey၊ viber_otp၊ rcs၊ flashcall
စာသား	string	မက်ဆေ့ခ်ျအကြောင်းအရာ (အမျိုးအစားအများစုအတွက် လိုအပ်သည်၊ အချို့အတွက် ရွေးချယ်နိုင်သည်)

ရွေးချယ်နိုင်သော ကန့်သတ်ချက်များ

ကန့်သတ်ချက်	ရိုက်	ဖော်ပြချက်
customerMessageId	string	ခြေရာခံခြင်း
ttl	ကိန်းပြည့်	Time-to-s live in စက္ကန့်
messageData	အရာဝတ္ထု	အမျိုးအစား-တိကျသောဖွဲ့စည်းမှုပုံစံ (မက်ဆေ့ခ်ျအမျိုးအစားအလိုက်ကွဲပြားသည်)

စစ်မှန်ကြောင်းအထောက်အထားပြခြင်း။

အထောက်အထားစိစစ်ခြင်းနည်းလမ်း သုံးခုထဲမှ တစ်ခုကို ရွေးပါ-

API Key HeaderHTTP အခြေခံ AuthAPI Key ကို Password အဖြစ်

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

တုံ့ပြန်မှု

အောင်မြင်မှုတုံ့ပြန်ခြင်း။

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

တုံ့ပြန်မှုနယ်ပယ်များ

လယ်	ရိုက်	ဖော်ပြချက်
messagelistId	ကိန်းပြည့်	မက်ဆေ့ချ်စာရင်း
messageId	string	မက်ဆေ့ဂျ်တစ်ခုစီအတွက် သီးသန့်သတ်မှတ်မှုစနစ်
အဆင့်အတန်း	string	မက်ဆေ့ချ်အခြေအနေ- လက်ခံသည်၊ ပယ်ချသည်၊ ပျက်ကွက်
အပိုင်း	ကိန်းပြည့်	မက်ဆေ့ဂျ်အပိုင်းအရေအတွက် (SMS အတွက်)
customerMessageId	string	သင့်အတွင်းပိုင်းသတ်မှတ်စနစ် (ပေးလျှင်)
to	string	လက်ခံသူဖုန်းနံပါတ်

မက်ဆေ့ခ်ျအမျိုးအစားများ

SMS

ရိုးရှင်းသော စာသားမက်ဆေ့ခ်ျများ

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Viber ပရိုမိုးရှင်း

ကြွယ်ဝသောမီဒီယာဖြင့် ပရိုမိုးရှင်းစာတိုများ-

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber မှ ငွေလွှဲခြင်း။

ငွေပေးငွေယူ အကြောင်းကြားချက်များ-

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

Viber OTP

တစ်ကြိမ်စကားဝှက် အသိပေးချက်များ-

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

ကိုင်တွယ်မှုအမှား

HTTP အခြေအနေကုဒ်များ

ကုတ်	ဖော်ပြချက်
200	တောင်းဆိုမှု အောင်မြင်
400	တောင်းဆိုမှု မမှန် - မမှန်ကန်သော ဘောင်များ
401	ခွင့်ပြုချက်မရှိဘဲ - စစ်မှန်ကြောင်းအထောက်အထား မအောင်မြင်ပါ
429	တောင်းဆိုမှုများ များလွန်းသည် - နှုန်းကန့်သတ်ချက်ကို ကျော်လွန်နေ
500	အတွင်းပိုင်း ဆာဗာ အမှားအယွင်း

အမှားတုံ့ပြန်မှု

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

အကောင်းဆုံးအလေ့အကျင့်များ

ဖုန်းနံပါတ်ဖော်မတ်

ဖုန်းနံပါတ်များအတွက် အမြဲတမ်း E.164 ဖော်မတ်ကို အသုံးပြုပါ-

• ✅ မှန်ကန်မှု- +380XXXXXXXXX
• ❌ မှားယွင်းနေသည်- 380XXXXXXXXX၊ 0XXXXXXXXX

မက်ဆေ့ခ်ျ စာသား

• အစိတ်အပိုင်းများစွာကိုရှောင်ရှားရန် SMS ကို 160 အောက်တွင်ထားပါ။
• နိုင်ငံတကာအက္ခရာများအတွက် UTF-8 ကုဒ်နံပါတ်ကိုသုံးပါ။
• အစုလိုက်မပို့မီ အထူးဇာတ်ကောင်များကို စမ်းသပ်ပါ။

TTL (အချိန်မှ တိုက်ရိုက်ထုတ်လွှင့်သည်)

• အချိန်ထိခိုက်လွယ်သော မက်ဆေ့ချ်များအတွက် သင့်လျော်သော TTL ကို သတ်မှတ်ပါ။
• OTP မက်ဆေ့ချ်များ- 300-600 စက္ကန့် (5-10 မိနစ်)
• ပရိုမိုးရှင်းမက်ဆေ့ချ်များ- 3600-86400 စက္ကန့် (1-24 နာရီ)

Customer Message ID

• မက်ဆေ့ဂျ်တစ်ခုစီအတွက် သီးသန့်သတ်မှတ်စနစ်ကို အသုံးပြုပါ။
• ခြေရာခံခြင်းနှင့်အမှားရှာပြင်ခြင်းနှင့်အတူကူညီပေးသည်။
• သင့်စနစ်၏ မှတ်တမ်းများနှင့် ဆက်စပ်မှုအတွက် အသုံးဝင်သည်။

နှုန်းထားကန့်သတ်ချက်များ

အချက်အလက်များအတွက် သင့်အကောင့်မန်နေဂျာထံ ဆက်သွယ်ပါ-

• တစ်စက္ကန့်လျှင်မက်ဆေ့ခ်ျများ
• တစ်နေ့လျှင်မက်ဆေ့ခ်ျများ
• တစ်ပြိုင်တည်းချိတ်ဆက်မှုများ

နောက်အဆင့်များ

• Viber Messages - Viber မက်ဆေ့ခ်ျအမျိုးအစားများကို စူးစမ်းပါ။
• SMS Messages - SMS အကြောင်း ပိုမိုလေ့လာပါ။
• Check Status - မက်ဆေ့ချ်ပေးပို့မှုကို ခြေရာခံပါ။