Sms-activatie-API

Haal je API-sleutel

Maak een account aan, open het paneel en genereer een sleutel onder API-toegang. Houd hem geheim: iedereen met de sleutel kan je saldo uitgeven.

Typische flow

1. Roep getNumber aan met een dienst en land.
2. Gebruik het nummer in de doel-app.
3. Vraag getStatus elke paar seconden op tot je STATUS_OK krijgt.
4. Roep setStatus aan met 6 om af te ronden, of 8 om te annuleren als er geen code kwam.

Met sms-activate compatibel endpoint

Stuur GET- of POST-verzoeken met de parameters api_key en action. Antwoorden zijn platte tekst, precies zoals sms-activate.

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

Acties

setStatus-waarden

3

Nog een code op hetzelfde nummer aanvragen

6

De activatie afronden

8

Annuleren en terugbetalen (mogelijk twee minuten na aankoop)

JSON REST-API

Stuur de sleutel in de Authorization-header als "Bearer KEY". Bedragen zijn strings in Amerikaanse dollars met vier decimalen.

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

Stel een URL in onder API-toegang in je paneel. Voor elke gebeurtenis sturen we een POST met een JSON-body. Antwoord binnen 10 seconden met een 2xx-status; anders proberen we het opnieuw na 1, 5, 30, 120, 360 en 720 minuten.

activation.sms_received

Er is een code binnengekomen voor een nummer dat je hebt gekocht.

activation.cancelled

Een nummer is geannuleerd of verlopen en het geld is teruggestort op je saldo.

rental.sms_received

Er is een sms binnengekomen op een gehuurd nummer.

rental.ended

Een huur is afgelopen of geannuleerd.

Voorbeeldbody

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

De handtekening controleren

Elk verzoek heeft een header X-Webhook-Signature zoals t=1730000000,v1=…, waarbij v1 de hexadecimale HMAC-SHA256 is van "t.body", gemaakt met je ondertekeningsgeheim. Weiger het verzoek als de handtekening niet klopt of t ouder is dan 5 minuten.

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

Fouten

BAD_KEY

De API-sleutel is onjuist of vervangen.

NO_NUMBERS

Op dit moment geen voorraad voor deze dienst en dit land.

NO_BALANCE

Je saldo is te laag voor dit nummer.

EARLY_CANCEL_DENIED

Annuleren kan twee minuten na aankoop.

NO_ACTIVATION

Het activatie-id bestaat niet of is niet van jou.