Histórico de ativações
O método getHistory é utilizado para obter o histórico de todas as ativações de números virtuais associados à conta via API SMS.online. Ele permite automatizar a análise das ativações realizadas e o monitoramento dos gastos com serviços.
O método é destinado a obter informações detalhadas sobre cada ativação, incluindo data, número de telefone, códigos SMS recebidos, custo e status atual. Isso facilita o acompanhamento do uso dos números e o controle das despesas.
Uma solicitação bem-sucedida retorna uma lista estruturada de ativações com dados detalhados: identificador único da ativação, data de criação, número de telefone, lista de mensagens SMS recebidas, custo (para ativas — 0) e status da ativação. O método é adequado para sistemas de análise e gestão de despesas com serviços.
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 | getHistory | Nome do método | |
| Não | Timestamp no formato Unix | A partir de qual data pegar ativações (limitado a 30 dias) | |
| Não | Timestamp no formato Unix | 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 API real.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getHistory`);# 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 | |
| Data inválida |