Solicitação de número
O método getNumber é utilizado para obter um número virtual descartável através da API SMS.online. Ele permite solicitar automaticamente um número para verificação em plataformas externas que exigem confirmação via SMS. O método aceita parâmetros de país, serviço e (opcionalmente) operador para seleção precisa do número.
Se a solicitação for bem-sucedida, uma string com um identificador único de ativação e o número será retornada. O método é destinado à integração em sistemas de registro automático e confirmação de contas via SMS.
Exemplo de solicitação:
Dados de entrada
| Parâmetro | Obrigatório | Observação | Descrição |
|---|---|---|---|
| Sim | Veja no perfil nas configurações Chave da API | A chave da API fornece acesso aos serviços pagos | |
| Sim | getNumber | Nome do método | |
| Sim | Veja a lista de serviços no menu à esquerda | Serviço, número para o qual é necessário obter | |
| Sim | Veja a lista de países no menu à esquerda | País, número que precisa ser obtido | |
| Não | Veja a lista de operadores no menu à esquerda | Operadora de telefonia, número que precisa ser obtido | |
| Não | Veja em Programa de Parceria | ID de referência | |
| Não | Valor numérico | Tipo de ativação: 0 - SMS (padrão), 1 - por número, 2 - por voz |
Resposta do servidor
ACCESS_NUMBER:ID:NUMBERNúmero obtido, ID de ativação - ID, número com código do país - NUMBER
Exemplo de código
const api_key = "API_KEY"; # Substitua 'API_KEY' pela sua chave de API real.const service = "SERVICE"; # Substitua 'SERVICE' pelo identificador do serviço. Todos os identificadores podem ser visualizados na documentação na lista do menu à esquerda.const country = 1; # Insira o número do país desejado. Os números de todos os países podem ser visualizados na documentação na lista do menu à esquerda.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getNumber&service=${service}&country=${country}`);# Realizamos uma solicitação GET para a URL especificadaconst data = await response.json();# Exibimos o conteúdo da resposta do servidorconsole.log(data);} catch (err) {# Se ocorreu um erro, exibimos a mensagem de erroconsole.error(err);}Possíveis erros
| Parâmetro | Descrição |
|---|---|
| Ação inválida | |
| Chave da API inválida | |
| Erro na solicitação | |
| Tempo pelo qual a conta está bloqueada | |
| Conta inativa | |
| Nome do serviço inválido | |
| Nome do país inválido | |
| Conta bloqueada | |
| Nenhum número disponível | |
| Saldo não encontrado |