API za aktivacijo SMS

Pridobite API ključ

Ustvarite račun, odprite ploščo in ustvarite ključ v razdelku Dostop do API. Hranite ga na skrivnem: kdorkoli ima ključ, lahko porablja vaše stanje.

Tipičen potek

1. Pokličite getNumber s storitvijo in državo.
2. Uporabite številko v ciljni aplikaciji.
3. Vsakih nekaj sekund preverjajte getStatus, dokler ne dobite STATUS_OK.
4. Pokličite setStatus s 6 za zaključek ali z 8 za preklic, če koda ni prispela.

Endpoint, združljiv s sms-activate

Pošiljajte zahteve GET ali POST s parametroma api_key in action. Odgovori so navadno besedilo, natanko kot pri sms-activate.

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

Dejanja

Vrednosti setStatus

3

Zahtevajte novo kodo na isto številko

6

Zaključite aktivacijo

8

Prekličite in vrnite (mogoče dve minuti po nakupu)

JSON REST API

Ključ pošljite v glavi Authorization kot "Bearer KEY". Zneski so nizi v ameriških dolarjih s štirimi decimalkami.

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

Spletni kavlji

Nastavite URL v razdelku Dostop do API na svoji plošči. Za vsak dogodek pošljemo POST s telesom JSON. Odgovorite s katerim koli stanjem 2xx v 10 sekundah; sicer poskusimo znova po 1, 5, 30, 120, 360 in 720 minutah.

activation.sms_received

Za kupljeno številko je prispela koda.

activation.cancelled

Številka je bila preklicana ali je potekla in denar se je vrnil v vaše stanje.

rental.sms_received

Na najeto številko je prispel SMS.

rental.ended

Najem se je končal ali je bil preklican.

Primer telesa

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

Preverjanje podpisa

Vsaka zahteva ima glavo X-Webhook-Signature v obliki t=1730000000,v1=…, kjer je v1 šestnajstiški HMAC-SHA256 iz "t.body", izračunan z vašo skrivnostjo za podpis. Zavrnite zahtevo, če se podpis ne ujema ali je t starejši od 5 minut.

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

Napake

BAD_KEY

API ključ je napačen ali je bil zamenjan.

NO_NUMBERS

Za to storitev in državo trenutno ni zaloge.

NO_BALANCE

Vaše stanje ne zadošča za to številko.

EARLY_CANCEL_DENIED

Preklic je mogoč dve minuti po nakupu.

NO_ACTIVATION

ID aktivacije ne obstaja ali ni vaš.