租赁历史查询
getRentHistory 方法用于通过 SMS.online API 获取与账户相关的所有租赁虚拟号码的完整列表。它可以自动化分析长期租赁的号码使用情况,并跟踪续租成本。
该方法提供获取租赁详细信息的功能,包括开始日期、有效期、电话号码、租赁状态和续租费用。这有助于监控当前和已完成的租赁,并评估长期使用号码的开支。
成功的请求将返回一个结构化对象,包含所有租赁号码的列表,包括租赁的唯一标识符、开始日期、有效期、电话号码、当前状态和租赁金额。该方法非常适合用于分析和监控租赁开支的系统。
请求示例:
输入数据
参数 | 必填 | 备注 | 描述 |
---|---|---|---|
是 | 请参见个人资料中的 API 密钥 设置 | API 密钥提供对付费服务的访问 | |
是 | getRentHistory | 方法名称 | |
否 | Unix 时间戳格式的时间戳 | 从哪个日期开始获取激活(限制为 30 天) | |
否 | Unix 时间戳格式的时间戳 | 到哪个日期获取激活(限制为 30 天) | |
否 | 数值 | 响应中返回的第一个元素的偏移量(默认值为 0) | |
否 | 数值 | 响应中返回的元素数量(默认值为 50,最大值为 100) |
服务器响应
JSON
[ { "id": 635468024, "date": "2022-11-12 15:58:39", "phone": "79918529716", "sms": "["Your sms code"]", "cost": 100 "status": "4" } ]
代码示例
const api_key = "API_KEY"; # 将 'API_KEY' 替换为您的实际 API 密钥。try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentHistory`);# 对指定的 URL 执行 GET 请求const data = await response.json();# 输出服务器响应的内容console.log(data);} catch (err) {# 如果发生错误,输出错误消息console.error(err);}
可能的错误
参数 | 描述 |
---|---|
不正确的操作 | |
无效的 API 密钥 | |
请求错误 | |
账户被禁用的时间 | |
账户未激活 | |
不正确的日期 |