SMS Rooms — Virtual Numbers for SMS Verification

Documentation API

Les requêtes POST et GET sont prises en charge.

Les requêtes doivent avoir une clé API comme paramètre api_key

Adresse pour les requêtes API: https://sms-rooms.com/stubs/handler_api.php

Obtenir un numéro

Requête:

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

Paramètres:

$api_keyVotre clé API
$serviceService à commander
$countryPays du numéro
$refID du compte(optionnel)
$maxPricePrix maximum(optionnel)

Réponse:

ACCESS_NUMBER:$activationId:$phoneNumber

Exemple de requête:

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

Réponse::

ACCESS_NUMBER:2887:17744056708

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte
BAD_SERVICE - nom de service incorrect
BAD_COUNTRY - nom de pays incorrect
NO_BALANCE - solde insuffisant
NO_NUMBERS - aucun numéro disponible

Vérifier le statut d'activation

Requête:

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

Paramètres:

$api_keyVotre clé API
$idID d'activation reçu dans getNumber

Réponse:

STATUS_OK:'Code SMS' ou STATUS_WAIT_CODE

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte
NO_ACTIVATION - l'ID d'activation n'existe pas

Vérifier le solde

Requête:

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

Paramètres:

$api_keyVotre clé API

Réponse:

ACCESS_BALANCE:'Solde du compte'

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte

Changer le statut d'activation

Requête:

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

Paramètres:

$api_keyVotre clé API
$idID d'activation
$statusStatut: 1-prêt, 3-redemander, 6-terminer, 8-annuler

Réponse:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Exemple de requête:

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

Réponse::

ACCESS_RETRY_GET

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte
NO_ACTIVATION - l'ID d'activation n'existe pas
BAD_STATUS - statut incorrect

Liste des services

Requête:

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

Paramètres:

$api_keyVotre clé API

Réponse:

{"code": "ID du service", "name": "Nom du service"}

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte

Liste des pays

Requête:

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

Paramètres:

$api_keyVotre clé API

Réponse:

{"id": "ID du pays", "rus": "Nom en russe", "eng": "Nom en anglais"}

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte

Nombre de numéros

Requête:

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

Paramètres:

$api_keyVotre clé API
$countryPays du numéro

Réponse:

{"code_service": "nombre_numeros"}

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte
BAD_COUNTRY - nom de pays incorrect

Liste des prix

Requête:

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

Paramètres:

$api_keyVotre clé API
$serviceService à commander(optionnel)
$countryPays du numéro(optionnel)

Réponse:

{"Code pays": {"Code service": {"Prix": Quantité}}}

Erreurs:

BAD_KEY - clé API invalide
BAD_ACTION - action incorrecte
BAD_COUNTRY - nom de pays incorrect
BAD_SERVICE - nom de service incorrect