Mudança de 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 é utilizado 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 para automatizar 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 permite manter o estado de ativação atualizado em sistemas integrados.

Exemplo de solicitação:

Dados de entrada

ParâmetroObrigatórioNotaDescrição
SimVeja no perfil nas configurações Chave APIA chave 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 momento?

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

As seguintes ações estão disponíveis:

8 - Cancelar ativação

Imediatamente após receber o código:

3 - Solicitar outro SMS

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

Para ativação com status 3:

6 - Confirmar o código SMS e concluir 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 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}`);
# Realizando uma solicitação GET para a URL especificada
const data = await response.json();
# Exibindo 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 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.