---
title: "API приёма SMS — документация и руководство по интеграции | SMS Activation — платформа приёма SMS | Receive SMS"
description: "Документация API, совместимого с популярными протоколами приёма SMS: проверка баланса, цены на номера, покупка виртуальных номеров и автоматический онлайн-приём кодов — быстрая интеграция в ваш проект."
canonical_url: "https://www.sms-activation.net/ru/api-doc"
locale: ru
meta:
  keywords: "api приёма смс,api виртуальных номеров,виртуальный номер api,смс онлайн,временный номер,api кода подтверждения,документация api"
  "og:description": "Документация API, совместимого с популярными протоколами приёма SMS: проверка баланса, цены на номера, покупка виртуальных номеров и автоматический онлайн-приём кодов — быстрая интеграция в ваш проект."
  "og:title": "API приёма SMS — документация и руководство по интеграции | SMS Activation — платформа приёма SMS | Receive SMS"
---

> Index of every page on this site: [llms.txt](https://www.sms-activation.net/llms.txt)

# **API приёма SMS — документация и руководство по интеграции**

Документация API, совместимого с популярными протоколами приёма SMS: проверка баланса, цены на номера, покупка виртуальных номеров и автоматический онлайн-приём кодов — быстрая интеграция в ваш проект.

Добро пожаловать в **SMS-Activation API**.

API — это протокол взаимодействия между вашим ПО и нашими серверами; наш API совместим с популярными платформами. Все запросы отправляются на `https://www.sms-activation.net/stubs/handler_api.php` методами `GET`/`POST`; каждый запрос обязан содержать API-ключ в параметре `api_key`.

---

### Общая информация (Overview)

| Пункт | Описание |
| --- | --- |
| Base URL | `https://www.sms-activation.net/stubs/handler_api.php` |
| Метод запроса | `GET`/`POST` |
| Формат ответа | текст или JSON |
| Авторизация | параметр `api_key` |

Каждый запрос обязан содержать два общих параметра:

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | Ваш API-ключ; получите его на [странице документации API](https://www.sms-activation.net/ru/api-doc), нажав «Показать API Key» |
| `action` | string | да | Вызываемый метод интерфейса — см. Обзор Action |

> Если `api_key` недействителен или отсутствует, будет возвращён `BAD_KEY`,
>
> если `action` не существует — `BAD_ACTION`.

---

### Обзор Action

| Action | Описание | Тип ответа |
| --- | --- | --- |
| `getBalance` | Проверка баланса аккаунта | текст |
| `getPrices` | Цены на номера и остатки на складе | JSON |
| `getNumber` | Покупка номера для приёма кода | текст |
| `setStatus` | Обновление статуса активации (подтверждение / повторная SMS / отмена) | текст |
| `getActiveActivations` | Все незавершённые активации текущего аккаунта | JSON |

---

### 1. Проверка баланса `getBalance`

Возвращает текущий доступный баланс аккаунта.

**Параметры запроса**

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | API-ключ |
| `action` | string | да | фиксированное значение `getBalance` |

**Пример запроса**

```
curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalance"
```

**Пример ответа**

```
ACCESS_BALANCE:128.50
```

**Возможные ошибки**

| Ответ | Описание |
| --- | --- |
| `BAD_KEY` | недействительный `api_key` |

---

### 2. Получение цен `getPrices`

Возвращает цены и остатки номеров по странам/сервисам; возможна фильтрация по `service` и `country`.

**Параметры запроса**

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | API-ключ |
| `action` | string | да | фиксированное значение `getPrices` |
| `service` | string | нет | код сервиса, например `tg` (Telegram); без параметра возвращаются все сервисы |
| `country` | number | нет | код страны, например `187` (США); без параметра возвращаются все страны |

**Пример запроса**

```
curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getPrices&service=tg&country=187"
```

**Пример ответа**

```
{
  "187": {
    "tg": {
      "cost": 13.5,
      "count": 5000,
      "physicalCount": 4800
    }
  }
}
```

Структура ответа: `{ код_страны: { код_сервиса: { cost, count, physicalCount } } }`:

| Поле | Описание |
| --- | --- |
| `cost` | цена номера (в юанях, пересчитана с учётом уровня аккаунта) |
| `count` | текущий доступный остаток номеров для страны/сервиса |
| `physicalCount` | остаток «физических» номеров (у некоторых сервисов поля может не быть) |

---

### 3. Получение номера `getNumber`

Покупает временный номер для приёма SMS с кодом от заданного сервиса.

**Параметры запроса**

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | API-ключ |
| `action` | string | да | фиксированное значение `getNumber` |
| `service` | string | да | код сервиса, например `tg` |
| `country` | number | да | код страны, например `187` |

**Пример запроса**

```
curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187"
```

**Пример ответа**

```
ACCESS_NUMBER:38223344:12015550123
```

Формат ответа — `ACCESS_NUMBER:{activationId}:{phoneNumber}`; сохраните `activationId` — он понадобится для последующих запросов и смены статуса.

**Возможные ошибки**

| Ответ | Описание |
| --- | --- |
| `NO_NUMBERS` | для сервиса/страны временно нет доступных номеров |
| `NO_BALANCE` | недостаточно средств на балансе |
| `BAD_SERVICE` | некорректные параметры `service` / `country` |

---

### 4. Обновление статуса активации `setStatus`

Вызывается после получения номера и сообщает системе о следующем шаге: повторная отправка SMS, подтверждение завершения или отмена активации.

**Параметры запроса**

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | API-ключ |
| `action` | string | да | фиксированное значение `setStatus` |
| `id` | string | да | `activationId`, возвращённый `getNumber` |
| `status` | number | да | целевой статус — см. таблицу ниже |

**Значения статусов**

| `status` | Значение |
| --- | --- |
| `3` | запросить ещё одну SMS (ждать следующий код) |
| `6` | подтвердить завершение активации |
| `8` | отменить активацию (в первые 2 минуты после покупки отмена недоступна) |

> `status=1` (номер готов) устанавливается системой автоматически — после `getNumber` передавать его вручную не нужно и нельзя.

**Пример запроса**

```
curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&id=38223344&status=6"
```

**Пример ответа**

```
ACCESS_ACTIVATION
```

**Возможные ошибки**

| Ответ | Описание |
| --- | --- |
| `BAD_STATUS` | значение `status` вне допустимого диапазона |
| `WRONG_ACTIVATION_ID` | `id` не существует или принадлежит другому аккаунту |
| `EARLY_CANCEL_DENIED` | попытка отмены (`status=8`) в первые 2 минуты после покупки |

---

### 5. Запрос активных активаций `getActiveActivations`

Возвращает все незавершённые (не подтверждённые и не отменённые) активации текущего аккаунта.

**Параметры запроса**

| Параметр | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `api_key` | string | да | API-ключ |
| `action` | string | да | фиксированное значение `getActiveActivations` |

**Пример запроса**

```
curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getActiveActivations"
```

**Пример ответа**

```
[
  {
    "activationId": "38223344",
    "phoneNumber": "12015550123",
    "countryCode": 187,
    "countryName": "United States",
    "countryNameCN": "美国",
    "serviceCode": "tg",
    "serviceNameCN": "Telegram",
    "activationStatus": 2,
    "status": 0,
    "activationCost": 13.5,
    "price_cn": 13.5,
    "activationTime": "2026-06-27T08:00:00.000Z",
    "canGetAnotherSms": true,
    "activationOperator": "",
    "discount": "",
    "repeated": "",
    "smsCode": ["123456"],
    "smsText": ["Your Telegram code: 123456"]
  }
]
```

**Описание полей**

| Поле | Описание |
| --- | --- |
| `activationId` | ID активации |
| `phoneNumber` | выделенный номер телефона |
| `countryCode` / `countryName` | код страны / название (англ.) |
| `serviceCode` / `serviceNameCN` | код сервиса / название |
| `activationCost` / `price_cn` | стоимость заказа |
| `smsCode` | список полученных кодов |
| `smsText` | список полных текстов полученных SMS |
| `canGetAnotherSms` | разрешено ли запросить следующую SMS |

---

### Коды ошибок (Error Codes)

| Код | Описание |
| --- | --- |
| `BAD_KEY` | недействительный `api_key` |
| `BAD_ACTION` | недействительный параметр `action` |
| `BAD_SERVICE` | недействительные параметры `service` или `country` |
| `BAD_STATUS` | недействительный параметр `status` |
| `NO_NUMBERS` | для сервиса/страны временно нет доступных номеров |
| `NO_BALANCE` | недостаточно средств на балансе |
| `WRONG_ACTIVATION_ID` | ID активации не существует или принадлежит другому аккаунту |
| `EARLY_CANCEL_DENIED` | попытка отмены активации в первые 2 минуты после покупки |

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://www.sms-activation.net/ru#website","@type":"WebSite","inLanguage":"ru-RU","name":"SMS-Activation","url":"https://www.sms-activation.net/ru","translationOfWork":{"@id":"https://www.sms-activation.net/#website"}},{"@id":"https://www.sms-activation.net/ru/api-doc#webpage","@type":"WebPage","description":"Документация API, совместимого с популярными протоколами приёма SMS: проверка баланса, цены на номера, покупка виртуальных номеров и автоматический онлайн-приём кодов — быстрая интеграция в ваш проект.","name":"API приёма SMS — документация и руководство по интеграции","url":"https://www.sms-activation.net/ru/api-doc","isPartOf":{"@id":"https://www.sms-activation.net/ru#website"},"potentialAction":[{"@type":"ReadAction","target":["https://www.sms-activation.net/ru/api-doc"]}]}]}
```

## Sitemap

See the full [sitemap](https://www.sms-activation.net/sitemap.md) for all pages.