# SMS илгээх үйлчилгээ (SMS)

> Өөрийн вэб, апп-аасаа SMS мессеж болон нэг удаагийн баталгаажуулах код (OTP) илгээх энгийн API.

- Slug: `sms`
- Type: API + web app
- Stage: beta
- Catalog page: https://link.mn/services/sms
- Homepage: https://sms.link.mn
- Authentication: `Authorization: Bearer $LINK_API_KEY` (one key per link.mn project; keep it server-side)
- Sign-in: link.mn account (single sign-on through OpenID Connect)

## Features

- Нэг API дуудлагаар SMS илгээх
- Нэвтрэх, бүртгэлийн баталгаажуулах код (OTP)
- Захиалга, төлбөрийн мэдэгдэл
- link.mn бүртгэлээрээ шууд нэвтэрнэ

## Overview

**sms.link.mn** нь таны вэб сайт эсвэл апп-аас хэрэглэгчиддээ SMS мессеж илгээх үйлчилгээ.

Хэрэглээний жишээ:

* Бүртгэл, нэвтрэлтийн баталгаажуулах код (OTP)
* Захиалга баталгаажсан, хүргэлт гарсан тухай мэдэгдэл
* Төлбөрийн сануулга

link.mn-д бүртгэлтэй бол sms.link.mn-д дахин бүртгүүлэх шаардлагагүй — нэг бүртгэлээр нэвтэрнэ.

## Pricing

Үнэ, үнэгүй квотын мэдээллийг link.mn-ийн нэгдсэн төлбөрийн систем нээгдэхэд энд нийтэлнэ.
Тэр хүртэл sms.link.mn-ийн өөрийн нөхцөл хүчинтэй.

## User guide

#### Хамгийн хялбар арга: AI agent-аар

1. [link.mn/build](https://link.mn/build?services=sms) дээр SMS-ийг сонгоод **API key ба prompt авах** дарна — төсөл ба `LINK_API_KEY` үүснэ.
2. Гарсан prompt-ыг Claude Code, Codex, Cursor-д өгнө.
3. Төслийн хуудаснаас `LINK_API_KEY`-г хуулж апп-ынхаа `.env` файлд тавина.

#### Түгээмэл асуудал

* **401** — key буруу эсвэл цуцлагдсан.
* **403 `service_not_enabled`** — энэ үйлчилгээг төсөлдөө идэвхжүүлээгүй.
* **402** — данс хоосон.
* **429** — хэт олон хүсэлт.
* **Key-г frontend (браузер)-д тавьж болох уу?** Үгүй. Key-г зөвхөн сервер талд хадгална.

## Developer guide

API reference (OpenAPI) болон жишээ кодыг sms.link.mn link.mn-д бүрэн холбогдмогц энд нийтэлнэ.

* Нэвтрэлт: `Authorization: Bearer <LINK_API_KEY>`
* Алдааны хариу: RFC 9457 Problem Details (`401`, `402`, `403`, `429`)
