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â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 | setStatus | Nome do método | |
Sim | Valor numérico | ID de ativação, obtido ao solicitar o número | |
Sim | Valor numérico | Status 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 servidor | Descriçã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úmeroconst status = 1; # Insira o novo status da tabela acimatry {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 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 |
---|---|
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. |