API за SMS активиране

Вземете API ключ

Създайте акаунт, отворете панела и генерирайте ключ в раздел API достъп. Пазете го в тайна: всеки с ключа може да харчи баланса ви.

Типичен поток

1. Извикайте getNumber с услуга и държава.
2. Използвайте номера в целевото приложение.
3. Питайте getStatus на всеки няколко секунди, докато получите STATUS_OK.
4. Извикайте setStatus с 6 за завършване или с 8 за отказ, ако не е дошъл код.

Endpoint, съвместим със sms-activate

Изпращайте GET или POST заявки с параметри api_key и action. Отговорите са обикновен текст, точно като при sms-activate.

https://smsrota.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=wa&country=187

Действия

Стойности на setStatus

3

Поискайте нов код на същия номер

6

Завършете активирането

8

Откажете и възстановете (възможно две минути след покупката)

JSON REST API

Изпращайте ключа в заглавката Authorization като "Bearer KEY". Сумите са низове в щатски долари с четири знака след десетичната запетая.

GET   https://smsrota.com/v1/balance
GET   https://smsrota.com/v1/prices?service=wa
POST  https://smsrota.com/v1/activations  {"service":"wa","country":"187"}
GET   https://smsrota.com/v1/activations/:id
POST  https://smsrota.com/v1/activations/:id/retry
POST  https://smsrota.com/v1/activations/:id/complete
POST  https://smsrota.com/v1/activations/:id/cancel
GET   https://smsrota.com/v1/rent/prices?service=wa&hours=24
POST  https://smsrota.com/v1/rentals  {"service":"full","country":"16","hours":24}
GET   https://smsrota.com/v1/rentals/:id
POST  https://smsrota.com/v1/rentals/:id/extend  {"hours":24}
POST  https://smsrota.com/v1/rentals/:id/finish
POST  https://smsrota.com/v1/rentals/:id/cancel
POST  https://smsrota.com/v1/rentals/:id/dispute  {"reason":"no_sms"}
PUT   https://smsrota.com/v1/webhook  {"url":"https://example.com/sms-webhook"}
POST  https://smsrota.com/v1/webhook/test
GET   https://smsrota.com/v1/webhook/events

Уебкуки

Задайте URL в API достъп във вашия панел. За всяко събитие изпращаме POST с JSON тяло. Отговорете с който и да е 2xx статус до 10 секунди; иначе опитваме отново след 1, 5, 30, 120, 360 и 720 минути.

activation.sms_received

Пристигна код за номер, който сте купили.

activation.cancelled

Номер беше отменен или изтече и парите се върнаха в баланса ви.

rental.sms_received

Пристигна SMS на нает номер.

rental.ended

Наем приключи или беше отменен.

Примерно тяло

{
  "id": "evt_1042",
  "type": "activation.sms_received",
  "createdAt": "2026-11-01T10:00:00.000Z",
  "data": {
    "activationId": 48151623,
    "service": "wa",
    "country": "187",
    "phone": "15550123456",
    "code": "123456"
  }
}

Проверка на подписа

Всяка заявка има заглавка X-Webhook-Signature във вида t=1730000000,v1=…, където v1 е шестнадесетичният HMAC-SHA256 на "t.body", изчислен с вашия таен ключ. Отхвърлете заявката, ако подписът не съвпада или t е по-старо от 5 минути.

import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody: the request body exactly as received, before JSON parsing.
function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  return fresh && v1.length === expected.length && timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

Грешки

BAD_KEY

API ключът е грешен или е бил заменен.

NO_NUMBERS

В момента няма наличност за тази услуга и държава.

NO_BALANCE

Балансът ви не стига за този номер.

EARLY_CANCEL_DENIED

Отказът е възможен две минути след покупката.

NO_ACTIVATION

Идентификаторът на активирането не съществува или не е ваш.