SMS aktiválási API

API kulcs beszerzése

Hozz létre fiókot, nyisd meg a panelt, és generálj kulcsot az API hozzáférés résznél. Tartsd titokban: aki ismeri a kulcsot, elköltheti az egyenlegedet.

Tipikus folyamat

1. Hívd meg a getNumber-t egy szolgáltatással és országgal.
2. Használd a számot a cél appban.
3. Kérdezd le a getStatus-t pár másodpercenként, amíg STATUS_OK-t nem kapsz.
4. Hívd meg a setStatus-t 6-tal a befejezéshez, vagy 8-cal a lemondáshoz, ha nem jött kód.

sms-activate kompatibilis végpont

Küldj GET vagy POST kéréseket api_key és action paraméterekkel. A válaszok egyszerű szövegek, pontosan mint az sms-activate-nél.

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

Műveletek

setStatus értékek

3

Újabb kód kérése ugyanarra a számra

6

Az aktiválás befejezése

8

Lemondás és visszatérítés (a vásárlás után két perccel lehetséges)

JSON REST API

Küldd a kulcsot az Authorization fejlécben "Bearer KEY" formában. Az összegek négy tizedesjegyű, amerikai dollárban megadott szövegek.

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

Webhookok

Adj meg egy URL-t a panel API hozzáférés részében. Minden eseményhez JSON törzsű POST kérést küldünk. Válaszolj bármilyen 2xx állapottal 10 másodpercen belül; különben 1, 5, 30, 120, 360 és 720 perc múlva újrapróbáljuk.

activation.sms_received

Kód érkezett egy megvásárolt számra.

activation.cancelled

Egy számot töröltek vagy lejárt, és a pénz visszakerült az egyenlegedre.

rental.sms_received

SMS érkezett egy bérelt számra.

rental.ended

Egy bérlés véget ért vagy törölték.

Példa törzs

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

Az aláírás ellenőrzése

Minden kérésben van egy X-Webhook-Signature fejléc, például t=1730000000,v1=…, ahol v1 a "t.body" hexadecimális HMAC-SHA256 értéke az aláírókulcsoddal számolva. Utasítsd el a kérést, ha az aláírás nem egyezik, vagy t 5 percnél régebbi.

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

Hibák

BAD_KEY

Az API kulcs hibás vagy le lett cserélve.

NO_NUMBERS

Jelenleg nincs készlet ehhez a szolgáltatáshoz és országhoz.

NO_BALANCE

Az egyenleged nem elég ehhez a számhoz.

EARLY_CANCEL_DENIED

A lemondás a vásárlás után két perccel lehetséges.

NO_ACTIVATION

Az aktiválási azonosító nem létezik, vagy nem a tiéd.