Histórico de Aluguel
O método getRentHistory é utilizado para obter a lista completa de todos os números virtuais alugados associados à conta via API SMS.online. Ele permite automatizar a análise do uso de números em aluguel de longo prazo e monitorar os custos de renovação.
O método fornece a possibilidade de obter informações detalhadas sobre o aluguel, incluindo data de início, duração, número de telefone, status do aluguel e custo de renovação. Isso permite controlar aluguéis atuais e finalizados, além de avaliar os gastos com o uso prolongado dos números.
Uma solicitação bem-sucedida retorna um objeto estruturado com a lista de todos os números alugados, incluindo o identificador único do aluguel, data de início, duração, número de telefone, status atual e valor do aluguel. O método é ideal para sistemas de análise e monitoramento de despesas de aluguel.
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 | getRentHistory | Nome do método | |
| Não | Timestamp no formato Unix Timestamp | A partir de qual data pegar ativações (limitado a 30 dias) | |
| Não | Timestamp no formato Unix Timestamp | Até qual data pegar ativações (limitado a 30 dias) | |
| Não | Valor numérico | Deslocamento do primeiro elemento retornado na resposta (padrão 0) | |
| Não | Valor numérico | Número de elementos retornados na resposta (padrão 50, máximo 100) |
Resposta do servidor
[
{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "["Your sms code"]",
"cost": 100
"status": "4"
}
]Exemplo de código
const api_key = "API_KEY"; # Substitua 'API_KEY' pela sua chave de API real.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentHistory`);# 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 |
|---|---|
| Ação inválida | |
| Chave da API inválida | |
| Erro na solicitação | |
| Tempo pelo qual a conta está bloqueada | |
| Conta inativa | |
| Data inválida |