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âmetro | Obrigatório | Nota | Descrição |
|---|---|---|---|
| Sim | Veja no perfil nas configurações Chave API | A chave 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 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 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 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}`);# Realizando uma solicitação GET para a URL especificadaconst data = await response.json();# Exibindo 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 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. |