FAQAPI

Renovação de aluguel de número virtual

O método continueRentNumber é utilizado para renovar o prazo de aluguel de um número virtual através da API SMS.online. Ele automatiza o processo de renovação, garantindo o uso contínuo do número alugado para receber SMS sem risco de perda.

Este método é ideal para situações em que é necessário usar o mesmo número por um longo período. Você pode definir o tempo de renovação, após o qual o sistema atualizará o prazo de aluguel e fornecerá uma confirmação de sucesso.

Um pedido bem-sucedido retorna um objeto com informações sobre o aluguel atualizado, incluindo o identificador do número, o novo prazo de aluguel e o valor debitado. Isso garante a estabilidade no recebimento de SMS durante o período estendido.

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
SimcontinueRentNumberNome do método
SimValor numéricoID de ativação, obtido ao solicitar o número
Sim4, 8, 12, 24, 72, 168, 360, 720, 2160Tempo de locação em horas

Resposta do servidor

JSON
{
  "status": "success",
  "phone": {
    "id": 1049,
    "endDate": "2020-01-31T12:01:52",
    "number": "79959707564"
  }
}

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 rent_time = 1; # Insira o tempo de renovação em horas da tabela acima
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=continueRentNumber&id=${id}&rent_time=${rent_time}`);
# 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
ID de locação não especificado
Número alugado não é seu (ID de locação incorreto)
Hora de renovação inválida
Saldo não encontrado
Status ausente ou incorretamente especificado