FAQAPI

Verificação do status de ativação

O método getStatus permite obter o status atual de ativação de um número virtual através da API SMS.online. É utilizado para verificar automaticamente o estado de ativação em plataformas externas que exigem confirmação via SMS.

O método possibilita acompanhar o processo de ativação após a obtenção do número e fornece informações sobre a entrega da mensagem com o código de confirmação, além de mostrar o estado atual do número no sistema.

Uma solicitação bem-sucedida retorna uma string com informações sobre o status atual de ativação, o status da mensagem e o código (se foi recebido). O método é prático para integração em sistemas que requerem monitoramento em tempo real.

Exemplo de solicitação:

Dados de entrada

ParâmetroObrigatórioObservaçãoDescrição
SimVeja no perfil nas configurações Chave da APIA chave da API fornece acesso aos serviços pagos
SimgetStatusNome do método
SimValor numéricoID de ativação, obtido ao solicitar o número

Resposta do servidor

Resposta do servidorDescrição
Aguardando código
Aguardando reenvio do SMS
Cancelado
Sucesso (onde $CODE é o código de ativação)

Exemplo de código

const api_key = "API_KEY"; # Substitua 'API_KEY' pela sua chave de API real.
const id = 1; # Insira o ID de ativação obtido ao solicitar o número
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getStatus&id=${id}`);
# Realizamos uma solicitação GET para a URL especificada
const data = await response.json();
# Exibimos o conteúdo da resposta do servidor
console.log(data);
} catch (err) {
# Se ocorreu um erro, exibimos a mensagem de erro
console.error(err);
}

Possíveis erros

ParâmetroDescrição
Ação inválida
Chave da API inválida
Erro na solicitação
Tempo pelo qual a conta está bloqueada
Conta inativa
Ativação não encontrada