މެސެޖް ފޮނުވުން
/bat/messagelist އެންޑްޕޮއިންޓް ބޭނުންކޮށްގެން އެސްއެމްއެސްބީއޭޓީ އެޕީއައި މެދުވެރިކޮށް މެސެޖުތައް ފޮނުވުން.
އެންޑްޕޮއިންޓް
POST /bat/messagelist
ރިކުއެސްޓް ސްޓްރަކްޗަރ
ރިކުއެސްޓް ބޮޑީ އަކީ މެސެޖް އޮބްޖެކްޓްތަކުގެ ޖޭއެސްއޯއެން އެރޭއެކެވެ:
{
"messages": [
{
"from": "YourSender",
"to": "+380XXXXXXXXX",
"type": "sms",
"text": "Your message text",
"customerMessageId": "your-internal-id",
"ttl": 3600
}
]
}
ޕެރެމިޓަރސް
ބޭނުންވާ ޕެރެމިޓަރސް
| ޕެރެމިޓަރ | ވައްތަރު | ތަފްސީލު |
|---|---|---|
އިން | ސްޓްރިންގް | އަލްފާނިއުމެރިކް ސެންޑަރ އައިޑީ |
އަށް | ސްޓްރިންގް | ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު އީ.164 ފޯމެޓުގައި (އެބަހީ، +380XXXXXXXXXX) |
ވައްތަރު | ސްޓްރިންގް | މެސެޖް ޓައިޕް: އެސްއެމްއެސް، ވައިބަރ_ޕްރޮމޯ، ވައިބަރ_ޓްރާންސް، ވައިބަރ_ކެރޮސެލް، ވައިބަރ_ސަރވޭ، ވައިބަރ_އޯޓީޕީ، އާރްސީއެސް، ފްލެޝްކޯލް |
ޓެކްސްޓް | ސްޓްރިންގް | މެސެޖް ކޮންޓެންޓް (ގިނަ ވައްތަރުތަކަށް ބޭނުންވާ، ބައެއް ވައްތަރުތަކަށް އިޚްތިޔާރީ) |
އިޚްތިޔާރީ ޕެރެމިޓަރސް
| ޕެރެމިޓަރ | ވައްތަރު | ތަފްސީލު |
|---|---|---|
ކަސްޓަމަރމެސެޖްއައިޑީ | ސްޓްރިންގް | ޓްރެކިންގ އަށް ތިބާގެ އިންޓަރނަލް އައިޑެންޓިފައިޓަރ |
ttl | އިންޓިޖަރ | ސިކުންތުކޮޅެއްގެ ތެރޭގައި ދިރިއުޅެން ޖެހޭ ވަގުތު |
މެސެޖްޑޭޓާ | އެއްޗެއް | ވައްތަރަކަށް ޚާއްޞަ ކޮންފިގްރޭޝަން (މެސެޖް ވައްތަރަށް ބަލާފައި ތަފާތުވެއެވެ) |
އޮތެންޓިކޭޝަން
އޮތެންޓިކޭޝަން ތިން ގޮތުގެ ތެރެއިން އެއް މެތޯޑެއް ހޮވާށެވެ:
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!"
}]
}'
ޖަވާބު
ކާމިޔާބީގެ ރައްދު
{
"messagelistId": 123456,
"messages": [
{
"messageId": "abc123def456",
"status": "accepted",
"parts": 1,
"customerMessageId": "your-internal-id",
"to": "+380XXXXXXXXX"
}
]
}
ޖަވާބުދާރީވުމުގެ ދާއިރާތައް
| ދަނޑު | ވައްތަރު | ތަފްސީލު |
|---|---|---|
މެސެޖެލިސްޓްއައިޑީ | އިންޓިޖަރ | މެސެޖް ލިސްޓަށް ޚާއްޞަ އައިޑެންޓިފައިޓަރ |
މެސެޖްއައިޑީ | ސްޓްރިންގް | ކޮންމެ މެސެޖަކަށް ޔުނިކް އައިޑެންޓިފައިޓަރ |
ސްޓޭޓަސް | ސްޓްރިންގް | މެސެޖް ސްޓޭޓަސް: އެކްސެޕްޓް، ރިޖެކްޓް، ފޭލް |
ބައިތައް | އިންޓިޖަރ | މެސެޖް ބައިތަކުގެ އަދަދު (އެސްއެމްއެސް އަށް) |
ކަސްޓަމަރމެސެޖްއައިޑީ | ސްޓްރިންގް | ތިބާގެ އެތެރޭގެ އައިޑެންޓިފައިޓަރ (ފޯރުކޮށްދީފައިވާނަމަ) |
އަށް | ސްޓްރިންގް | ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު |
މެސެޖް ވައްތަރުތައް
އެސްއެމްއެސް
ސާދާ ޓެކްސްޓް މެސެޖުތައް:
{
"from": "YourSender",
"to": "+380XXXXXXXXX",
"type": "sms",
"text": "Your SMS message text"
}
ވައިބަރ ޕްރޮމޯ
ރިޗް މީޑިއާ އާއި އެކު ޕްރޮމޯޝަނަލް މެސެޖުތައް:
{
"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"
}
}
}
ވައިބަރ ޓްރާންސެކްޝަނަލް
މުއާމަލާތުގެ ނޮޓިފިކޭޝަންތައް:
{
"from": "YourSender",
"to": "+380XXXXXXXXX",
"type": "viber_trans",
"text": "Your order #12345 has been confirmed"
}
ވައިބަރ އޯޓީޕީ
އެއްފަހަރު ޕާސްވޯޑް ނޮޓިފިކޭޝަން ދިނުން:
{
"from": "YourSender",
"to": "+380XXXXXXXXX",
"type": "viber_otp",
"messageData": {
"code": "123456",
"validity": 300
}
}
އެރަރ ހެންޑްލިންގ
އެޗްޓީޓީޕީ ސްޓޭޓަސް ކޯޑްސް
| ކޯޑް | ތަފްސީލު |
|---|---|
| 200 | ރިކުއެސްޓް ކާމިޔާބު |
| 400 ރުފިޔާ | ނުބައި ރިކުއެސްޓް - ސައްހަ ނޫން ޕެރެމިޓަރުތައް |
| 401 ރުފިޔާ | ހުއްދަ ނެތި - ތަސްދީގުކުރުން ނާކާމިޔާބު |
| 429 | މާ ގިނައިން ރިކުއެސްޓް - ރޭޓް ލިމިޓް ފަހަނައަޅައި ދިޔައީ |
| 500 ރުފިޔާ | އެތެރޭގެ ސަރވަރ އެރަރ |
އެރަރ ރެސްޕޮންސް
{
"error": {
"code": "INVALID_RECIPIENT",
"message": "Invalid phone number format"
}
}
އެންމެ ރަނގަޅު އުސޫލުތައް
ފޯނު ނަންބަރު ފޯމެޓް
ފޯނު ނަންބަރުތަކަށް އަބަދުވެސް އީ.164 ފޯމެޓް ބޭނުންކުރުން:
- ✅ ރަނގަޅު:
+380XXXXXXXXX - ❌ ގޯސް:
380XXXXXXXXXX،0XXXXXXXXXX
މެސެޖް ޓެކްސްޓް
- އެސްއެމްއެސް 160 އަކުރުގެ ދަށުގައި ބެހެއްޓުމަކީ އެތައް ބައިތަކެއް ނުހިމެނޭނެ ގޮތަށް ބެހެއްޓުން
- ބައިނަލްއަޤްވާމީ އަކުރުތަކަށް ޔޫޓީއެފް-8 އެންކޯޑިންގ ބޭނުންކުރުން
- ބަލްކް ފޮނުވުމުގެ ކުރިން ޚާއްޞަ އަކުރުތައް ޓެސްޓްކުރުން
ޓީޓީއެލް (ޓައިމް-ޓު-ލައިވް)
- ވަގުތަށް ނާޒުކު މެސެޖުތަކަށް އެކަށީގެންވާ ޓީޓީއެލް ސެޓްކުރުން
- އޯޓީޕީ މެސެޖުތައް: 300-600 ސިކުންތު (5-10 މިނެޓް)
- ޕްރޮމޯޝަނަލް މެސެޖުތައް: 3600-86400 ސިކުންތު (1-24 ގަޑިއިރު)
ކަސްޓަމަރ މެސެޖް އައިޑީ
- ކޮންމެ މެސެޖަކަށް ޔުނިކް އައިޑެންޓިފައިޓަރސް ބޭނުންކުރުން
- ޓްރެކިންގ އަދި ޑިބަގިންގ އަށް އެހީތެރިވެދެއެވެ
- ތިމާގެ ސިސްޓަމްގެ ރެކޯޑްތަކާ ގުޅިގެން މަސައްކަތް ކުރުމަށް ބޭނުންތެރި
ރޭޓް ލިމިޓްސް
މިކަމާ ބެހޭ މައުލޫމާތު ހޯދުމަށް އެކައުންޓް މެނޭޖަރާ ގުޅާށެވެ:
- ސިކުންތަކަށް މެސެޖުތައް
- ދުވާލަކު މެސެޖުތައް ފޮނުވުން
- އެއްފަހަރާ ގުޅުންތައް
ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް
- ވައިބަރ މެސެޖްސް - ވައިބަރ މެސެޖް ވައްތަރުތައް ހޯދުން
- އެސްއެމްއެސް މެސެޖްތައް - އެސްއެމްއެސް އާއި ބެހޭ އިތުރު މައުލޫމާތު ހޯއްދަވާށެވެ
- ޗެކް ސްޓޭޓަސް - މެސެޖް ޑެލިވަރީ ޓްރެކްކުރުން