SMS Rooms — Virtual Numbers for SMS Verification

Documentação da API

InícioAPI

São suportados pedidos POST e GET.

Os pedidos devem incluir uma chave API como parâmetro api_key

O acesso à API requer um depósito total de pelo menos 10 $ na conta. É considerada a soma acumulada dos depósitos durante toda a existência da conta, e não o saldo atual. Depois de atingido o limite, o acesso mantém-se independentemente das alterações do saldo. Abaixo desse limite, os pedidos devolvem NO_BALANCE:MIN_DEPOSIT_10.

Endereço do pedido à API: https://sms-rooms.com/stubs/handler_api.php

Obter número

Pedido:

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

Parâmetros:

$api_keyA sua chave API
$serviceServiço a encomendar
$countryPaís do número
$refID da conta(opcional)
$maxPricePreço máximo(opcional)

Resposta:

ACCESS_NUMBER:$activationId:$phoneNumber

Exemplo de pedido:

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

Resposta::

ACCESS_NUMBER:2887:17744056708

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta
BAD_SERVICE — nome de serviço incorreto
BAD_COUNTRY — nome de país incorreto
NO_BALANCE — saldo insuficiente
NO_NUMBERS — sem números disponíveis

Verificar estado da ativação

Pedido:

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

Parâmetros:

$api_keyA sua chave API
$idID de ativação recebido em getNumber

Resposta:

STATUS_OK:'Código SMS' ou STATUS_WAIT_CODE

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta
NO_ACTIVATION — o ID de ativação não existe

Verificar saldo

Pedido:

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

Parâmetros:

$api_keyA sua chave API

Resposta:

ACCESS_BALANCE:'Saldo da conta'

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta

Alterar o estado da ativação

Pedido:

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

Parâmetros:

$api_keyA sua chave API
$idID de ativação
$statusEstado: 1 — pronto, 3 — pedir de novo, 6 — concluir, 8 — cancelar

Resposta:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Exemplo de pedido:

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

Resposta::

ACCESS_RETRY_GET

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta
NO_ACTIVATION — o ID de ativação não existe
BAD_STATUS — estado incorreto

Lista de serviços

Pedido:

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

Parâmetros:

$api_keyA sua chave API

Resposta:

{"code": "ID do serviço", "name": "Nome do serviço"}

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta

Lista de países

Pedido:

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

Parâmetros:

$api_keyA sua chave API

Resposta:

{"id": "ID do país", "rus": "Nome em russo", "eng": "Nome em inglês"}

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta

Contagem de números

Pedido:

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

Parâmetros:

$api_keyA sua chave API
$countryPaís do número

Resposta:

{"service_code": "numbers_count"}

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta
BAD_COUNTRY — nome de país incorreto

Lista de preços

Pedido:

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

Parâmetros:

$api_keyA sua chave API
$serviceServiço a encomendar(opcional)
$countryPaís do número(opcional)

Resposta:

{"Código do país": {"Código do serviço": {"Preço": Contagem}}}

Erros:

BAD_KEY — chave API inválida
BAD_ACTION — ação incorreta
BAD_COUNTRY — nome de país incorreto
BAD_SERVICE — nome de serviço incorreto