Renovação de aluguel de número virtual
O método continueRentNumber é utilizado para renovar o 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.
Esse método é ideal para situações em que é necessário o uso prolongado do mesmo número. Você pode definir o período de renovação, após o qual o sistema atualizará a validade do aluguel e fornecerá uma confirmação da renovação bem-sucedida.
Uma solicitação bem-sucedida retorna um objeto com informações sobre o aluguel atualizado, incluindo o identificador do número, o novo prazo de validade do aluguel e o valor cobrado. Isso garante a estabilidade no recebimento de SMS durante o período estendido.
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 | continueRentNumber | Nome do método | |
| Sim | Valor numérico | ID de ativação obtido ao solicitar o número | |
| Sim | 4, 8, 12, 24, 72, 168, 360, 720, 2160 | Tempo de aluguel em horas |
Resposta do servidor
{
"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 API real.const id = 1; # Insira o ID de ativação obtido ao solicitar o númeroconst rent_time = 1; # Insira o tempo de renovação em horas da tabela acimatry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=continueRentNumber&id=${id}&rent_time=${rent_time}`);# 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 |
|---|---|
| Ação inválida | |
| Chave API inválida | |
| Erro na solicitação | |
| Tempo pelo qual a conta está bloqueada | |
| Conta inativa | |
| ID de aluguel não especificado | |
| Número alugado não pertence a você (ID de aluguel incorreto) | |
| Hora de renovação inválida | |
| Saldo não encontrado | |
| Status ausente ou incorretamente especificado |