API na aktiváciu SMS

Získajte API kľúč

Vytvorte účet, otvorte panel a vygenerujte kľúč v sekcii Prístup k API. Držte ho v tajnosti: ktokoľvek s kľúčom môže míňať váš zostatok.

Typický postup

1. Zavolajte getNumber so službou a krajinou.
2. Použite číslo v cieľovej aplikácii.
3. Dotazujte getStatus každých pár sekúnd, kým nedostanete STATUS_OK.
4. Zavolajte setStatus so 6 na dokončenie alebo s 8 na zrušenie, ak kód neprišiel.

Endpoint kompatibilný so sms-activate

Posielajte požiadavky GET alebo POST s parametrami api_key a action. Odpovede sú čistý text, presne ako pri sms-activate.

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

Akcie

Hodnoty setStatus

3

Vyžiadať ďalší kód na rovnaké číslo

6

Dokončiť aktiváciu

8

Zrušiť a vrátiť peniaze (možné dve minúty po kúpe)

JSON REST API

Posielajte kľúč v hlavičke Authorization ako "Bearer KEY". Sumy sú reťazce v amerických dolároch so štyrmi desatinnými miestami.

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

Webhooky

Nastavte URL v sekcii Prístup k API vo svojom paneli. Pre každú udalosť pošleme POST s telom JSON. Odpovedzte ľubovoľným stavom 2xx do 10 sekúnd; inak to skúsime znova po 1, 5, 30, 120, 360 a 720 minútach.

activation.sms_received

Pre číslo, ktoré ste kúpili, prišiel kód.

activation.cancelled

Číslo bolo zrušené alebo vypršalo a peniaze sa vrátili na váš zostatok.

rental.sms_received

Na prenajaté číslo prišla SMS.

rental.ended

Prenájom skončil alebo bol zrušený.

Ukážkové telo

{
  "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"
  }
}

Overenie podpisu

Každá požiadavka má hlavičku X-Webhook-Signature v tvare t=1730000000,v1=…, kde v1 je hexadecimálny HMAC-SHA256 z "t.body" vytvorený vaším podpisovým kľúčom. Požiadavku odmietnite, ak podpis nesedí alebo je t staršie ako 5 minút.

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));
}

Chyby

BAD_KEY

API kľúč je nesprávny alebo bol nahradený.

NO_NUMBERS

Pre túto službu a krajinu teraz nič nie je na sklade.

NO_BALANCE

Váš zostatok na toto číslo nestačí.

EARLY_CANCEL_DENIED

Zrušiť sa dá dve minúty po kúpe.

NO_ACTIVATION

ID aktivácie neexistuje alebo vám nepatrí.