SMS Rooms — Virtual Numbers for SMS Verification

API-Dokumentation

StartseiteAPI

POST- und GET-Anfragen werden unterstützt.

Anfragen müssen einen API-Schlüssel als Parameter haben api_key

Der API-Zugang wird ab einer Gesamteinzahlung von 10 $ auf das Konto freigeschaltet. Maßgeblich ist die Summe aller Einzahlungen über die gesamte Laufzeit des Kontos, nicht das aktuelle Guthaben. Sobald die Schwelle erreicht ist, bleibt der Zugang unabhängig von Guthabenänderungen bestehen. Anfragen unterhalb dieser Schwelle geben NO_BALANCE:MIN_DEPOSIT_10 zurück.

API-Anfrageadresse: https://sms-rooms.com/stubs/handler_api.php

Nummer erhalten

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&maxPrice=$maxPrice

Parameter:

$api_keyIhr API-Schlüssel
$serviceZu bestellender Dienst
$countryNummernland
$refKonto-ID(optional)
$maxPriceMaximaler Preis(optional)

Antwort:

ACCESS_NUMBER:$activationId:$phoneNumber

Beispielanfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187&maxPrice=5

Antwort::

ACCESS_NUMBER:2887:17744056708

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion
BAD_SERVICE - falscher Dienstname
BAD_COUNTRY - falscher Ländername
NO_BALANCE - unzureichendes Guthaben
NO_NUMBERS - keine verfügbaren Nummern

Aktivierungsstatus prüfen

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Parameter:

$api_keyIhr API-Schlüssel
$idAktivierungs-ID aus getNumber

Antwort:

STATUS_OK:'SMS-Code' oder STATUS_WAIT_CODE

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion
NO_ACTIVATION - Aktivierungs-ID existiert nicht

Guthaben prüfen

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

Parameter:

$api_keyIhr API-Schlüssel

Antwort:

ACCESS_BALANCE:'Kontoguthaben'

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion

Aktivierungsstatus ändern

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

Parameter:

$api_keyIhr API-Schlüssel
$idAktivierungs-ID
$statusStatus: 1-bereit, 3-nochmal anfordern, 6-abschließen, 8-abbrechen

Antwort:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Beispielanfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&status=3&id=2887

Antwort::

ACCESS_RETRY_GET

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion
NO_ACTIVATION - Aktivierungs-ID existiert nicht
BAD_STATUS - falscher Status

Dienste-Liste

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Parameter:

$api_keyIhr API-Schlüssel

Antwort:

{"code": "Service-ID", "name": "Service-Name"}

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion

Länder-Liste

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getCountries

Parameter:

$api_keyIhr API-Schlüssel

Antwort:

{"id": "Länder-ID", "rus": "Name auf Russisch", "eng": "Name auf Englisch"}

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion

Anzahl der Nummern

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Parameter:

$api_keyIhr API-Schlüssel
$countryNummernland

Antwort:

{"service_code": "anzahl_nummern"}

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion
BAD_COUNTRY - falscher Ländername

Preisliste

Anfrage:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Parameter:

$api_keyIhr API-Schlüssel
$serviceZu bestellender Dienst(optional)
$countryNummernland(optional)

Antwort:

{"Ländercode": {"Servicecode": {"Preis": Anzahl}}}

Fehler:

BAD_KEY - ungültiger API-Schlüssel
BAD_ACTION - falsche Aktion
BAD_COUNTRY - falscher Ländername
BAD_SERVICE - falscher Dienstname