API for SMS-aktivering

Få API-nøkkelen din

Opprett en konto, åpne panelet og generer en nøkkel under API-tilgang. Hold den hemmelig: Alle som har nøkkelen kan bruke saldoen din.

Typisk flyt

1. Kall getNumber med en tjeneste og et land.
2. Bruk nummeret i målappen.
3. Spør getStatus med noen sekunders mellomrom til du får STATUS_OK.
4. Kall setStatus med 6 for å fullføre, eller 8 for å avbryte hvis ingen kode kom.

Endepunkt kompatibelt med sms-activate

Send GET- eller POST-forespørsler med parameterne api_key og action. Svarene er ren tekst, akkurat som hos sms-activate.

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

Handlinger

Verdier for setStatus

3

Be om en ny kode på samme nummer

6

Fullfør aktiveringen

8

Avbryt og refunder (mulig to minutter etter kjøp)

JSON REST-API

Send nøkkelen i Authorization-headeren som "Bearer KEY". Beløp er strenger i amerikanske dollar med fire desimaler.

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

Webhooks

Angi en URL under API-tilgang i panelet ditt. Vi sender en POST med JSON-body for hver hendelse. Svar med en hvilken som helst 2xx-status innen 10 sekunder; ellers prøver vi igjen etter 1, 5, 30, 120, 360 og 720 minutter.

activation.sms_received

Det kom en kode til et nummer du kjøpte.

activation.cancelled

Et nummer ble kansellert eller utløp, og pengene gikk tilbake til saldoen din.

rental.sms_received

Det kom en SMS på et leid nummer.

rental.ended

En leie er avsluttet eller ble kansellert.

Eksempel på body

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

Sjekke signaturen

Hver forespørsel har en X-Webhook-Signature-header som t=1730000000,v1=…, der v1 er den heksadesimale HMAC-SHA256 av "t.body" laget med signeringsnøkkelen din. Avvis forespørselen hvis signaturen ikke stemmer eller t er eldre enn 5 minutter.

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

Feil

BAD_KEY

API-nøkkelen er feil eller har blitt byttet ut.

NO_NUMBERS

Ikke noe lager for denne tjenesten og dette landet akkurat nå.

NO_BALANCE

Saldoen din er for lav for dette nummeret.

EARLY_CANCEL_DENIED

Du kan avbryte to minutter etter kjøp.

NO_ACTIVATION

Aktiverings-ID-en finnes ikke eller tilhører ikke deg.