Alteração do status de ativação

O método setStatus permite gerenciar o estado de ativação de um número virtual através da API SMS.online. Ele é usado para alterar o status atual do número no sistema, por exemplo, ao concluir a ativação ou cancelar o uso do número.

Esse método é útil na automação de processos relacionados à gestão de números virtuais, quando é necessário atualizar rapidamente o status de ativação em tempo real.

Após uma solicitação bem-sucedida, o sistema atualiza o status do número, incluindo informações sobre ativação bem-sucedida, cancelamento ou outras operações relacionadas ao uso do número. Isso ajuda a manter o estado de ativação atualizado em sistemas integrados.

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
SimsetStatusNome do método
SimValor numéricoID de ativação, obtido ao solicitar o número
SimValor numéricoStatus da ativação

Qual status enviar em cada situação?

Logo após receber o número, ele fica aguardando SMS.

Você pode realizar as seguintes ações:

8 - Cancelar ativação

Imediatamente após receber o código:

3 - Solicitar outro SMS

6 - Confirmar o código SMS e finalizar a ativação

Para ativação com status 3:

6 - Confirmar o código SMS e finalizar a ativação

Resposta do servidor

Resposta do servidorDescrição
Aguardando reativação
Ativação concluída com sucesso
Ativação cancelada

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
const status = 1; # Insira o novo status da tabela acima
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setStatus&id=${id}&status=${status}`);
# 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
Chave da API inválida
Ação inválida
Erro na solicitação
Tempo pelo qual a conta está bloqueada
Conta inativa
Não é possível cancelar o número nos primeiros 2 minutos
Ativação não encontrada
Status inválido
ID inválido ou ID não é um número.