API för sms-aktivering

Skaffa din API-nyckel

Skapa ett konto, öppna panelen och generera en nyckel under API-åtkomst. Håll den hemlig: den som har nyckeln kan spendera ditt saldo.

Typiskt flöde

1. Anropa getNumber med en tjänst och ett land.
2. Använd numret i målappen.
3. Fråga getStatus med några sekunders mellanrum tills du får STATUS_OK.
4. Anropa setStatus med 6 för att slutföra, eller 8 för att avbryta om ingen kod kom.

Endpoint kompatibel med sms-activate

Skicka GET- eller POST-anrop med parametrarna api_key och action. Svaren är ren text, precis som hos sms-activate.

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

Åtgärder

Värden för setStatus

3

Begär en ny kod till samma nummer

6

Slutför aktiveringen

8

Avbryt och återbetala (möjligt två minuter efter köpet)

JSON REST-API

Skicka nyckeln i Authorization-headern som "Bearer KEY". Belopp är strängar i amerikanska dollar med fyra decimaler.

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

Ange en URL under API-åtkomst i din panel. Vi skickar en POST med JSON-body för varje händelse. Svara med valfri 2xx-status inom 10 sekunder; annars försöker vi igen efter 1, 5, 30, 120, 360 och 720 minuter.

activation.sms_received

En kod har kommit till ett nummer du köpt.

activation.cancelled

Ett nummer avbröts eller gick ut och pengarna gick tillbaka till ditt saldo.

rental.sms_received

Ett sms har kommit till ett hyrt nummer.

rental.ended

En hyra har tagit slut eller avbrutits.

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

Kontrollera signaturen

Varje begäran har en X-Webhook-Signature-header som t=1730000000,v1=…, där v1 är den hexadecimala HMAC-SHA256 av "t.body" gjord med din signeringsnyckel. Avvisa begäran om signaturen inte stämmer eller om t är äldre än 5 minuter.

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

Fel

BAD_KEY

API-nyckeln är fel eller har ersatts.

NO_NUMBERS

Inget lager för den här tjänsten och landet just nu.

NO_BALANCE

Ditt saldo räcker inte för det här numret.

EARLY_CANCEL_DENIED

Det går att avbryta två minuter efter köpet.

NO_ACTIVATION

Aktiverings-id:t finns inte eller är inte ditt.