SMS Rooms — Virtual Numbers for SMS Verification

API-Dokumentation

POST- und GET-Anfragen werden unterstützt.

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

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