API заавар

SMS илгээх

Нэг дугаар руу шууд, эсвэл олон дугаар руу багцаар SMS илгээнэ.

POST/v1/sms

Нэг дугаар руу илгээнэ. Хариу ирэхэд мессеж операторт хүлээлгэн өгөгдсөн байна.

Биеийн талбарууд

tostringзаавал: 8 оронтой дугаар. +976, зай, зураастай байж болно. Unitel, Mobicom, Skytel, G-Mobile дэмжинэ.
textstringзаавал: Мессежийн агуулга. Хамгийн ихдээ 5 хэсэг.

curl -X POST https://api.wesend.mn/v1/sms \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "99112233",
  "text": "Tanii zahialga batalgaajlaa. #1042"
}'

Хариу200 OK

{
  "id": "0b9c1a52-6f0e-4d8b-9a3c-2f1e5d7c8a90",
  "status": "sent",
  "channel": "sms",
  "to": "99112233",
  "parts": 1,
  "rate_multiplier": 1,
  "credits": 70,
  "batch_id": null,
  "error": null,
  "created_at": "2026-10-06T08:15:30.000Z",
  "sent_at": "2026-10-06T08:15:31.000Z",
  "balance": 4930
}

Оператор мессежийг хүлээн аваагүй бол 502 provider_failed буцаж, кредит буцаагдана. Алдааны id талбарт амжилтгүй мессежийн дугаар байна.

Хэсэг ба үнэ

Урт мессеж хэд хэдэн хэсэг болж тооцогдоно. Үнэ = хэсгийн тоо × нэг хэсгийн кредит × баярын үржүүлэгч.

Агуулга	Нэг хэсэг
Зөвхөн латин үсэг, тоо, энгийн тэмдэгт	150 тэмдэгт
Кирилл үсэг, эможи, эсвэл `[ \ ] ^ { \| } ~` болон урвуу хашилтын (`) аль нэг орсон	60 тэмдэгт

Кирилл мессеж латинаас 2.5 дахин үнэтэй тусна. 5 хэсгээс урт мессеж 422 message_too_long алдаа буцаана. Эможи 2 тэмдэгтээр тооцогдоно.

Олон дугаар руу илгээх

POST/v1/sms/bulk

Нэг агуулгыг 1,000 хүртэл дугаар руу илгээнэ. Мессежүүд дараалалд орж, ар талд илгээгдэнэ.

Биеийн талбарууд

tostring[]заавал: 1–1,000 дугаар. Давхардсан дугаарыг нэг болгоно.
textstringзаавал: Бүх хүлээн авагчид очих агуулга.

curl -X POST https://api.wesend.mn/v1/sms/bulk \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "99112233",
    "88112233",
    "95112233"
  ],
  "text": "Shine baraa irlee! shop.mn"
}'

Хариу202 Accepted

{
  "id": "5d2a7c1e-93b4-4f6a-8e0d-b1c2d3e4f5a6",
  "status": "processing",
  "channel": "sms",
  "total": 3,
  "sent": 0,
  "failed": 0,
  "credits": 210,
  "created_at": "2026-10-06T08:15:30.000Z",
  "completed_at": null,
  "balance": 4720
}

Багцын нийт кредитийг эхэнд нь нэг дор суутгана. Илгээгдээгүй мессеж бүрийн кредит буцна.
Нэг ч буруу эсвэл дэмжигдээгүй дугаар байвал хүсэлт бүхлээрээ 400 invalid_request болж, алдааны invalid талбарт буруу дугааруудыг (50 хүртэл) жагсаана. Юу ч илгээгдэхгүй, суутгагдахгүй.
Явцыг GET /batches/{id}-ээр шалгана.