SMS Arena API
Документация API
Программный доступ к тем же возможностям, что и в кабинете: аренда под сервис, полная аренда номера, входящие SMS, баланс и продления.
https://api.sms-arena.com/v1API-доступ
Загружаем ключи…
Авторизация
Все методы /v1 требуют ключ. Основной способ — заголовок X-API-Key.
| Способ | Формат |
|---|---|
| API-ключ | X-API-Key: sa_live_… |
| Bearer | Authorization: Bearer sa_live_… |
curl -H "X-API-Key: sa_live_…" https://api.sms-arena.com/v1/Balance
Баланс
GET/v1/Balance
Возвращает баланс кошелька кабинета в USD.
{
"balance": 12.5,
"accountBalanceInUSD": 12.5,
"currency": "USD",
"user_id": 42
}Каталог
Страны и цены — те же данные, что видит сайт.
GET/v1/Countries?rentalType=service|full
Список стран для rentalType=service или full.
GET/v1/ProductPrices?country=DE&rentalType=service
Цены аренды под сервис (пагинация page/limit).
GET/v1/ProductPrices?country=DE&rentalType=full
Доступные сроки полной аренды номера для страны.
GET/v1/products/{service_id}/options?country=DE
Варианты срока и цены для одного сервиса в стране.
Заказы и аренды
Создание аренды списывает баланс. 402 — недостаточно средств, 503 — нет в наличии.
POST/v1/Orders
Аренда под сервис:
{
"rentalType": "service",
"country": "DE",
"service_id": 123,
"days": 7
}Полная аренда номера:
{
"rentalType": "full",
"country": "DE",
"days": 30
}GET/v1/Orders
Последние заказы аккаунта.
GET/v1/OrderBookings
Список аренд. Опционально ?status=active.
GET/v1/OrderBookings/{id}
Одна аренда по ID.
Входящие SMS
GET/v1/Sms
Последние SMS по аккаунту (до 100).
GET/v1/Sms/{booking_id}
SMS по конкретной аренде. Опрашивайте endpoint, пока ждёте код.
Продление
GET/v1/OrderBookings/{id}/ExtendOptions
Доступные сроки и цены продления (как в кабинете).
POST/v1/OrderBookings/{id}/Extend
Продлить активную аренду. Списывает баланс.
{ "days": 7 }Важно
Баланс — USD-кошелёк кабинета. Поддерживаются срочная аренда под сервис и полная аренда номера.