活跃租赁号码列表
getRentList 方法用于获取与您的账户关联的所有租赁虚拟号码的最新列表,通过 SMS.online API 实时跟踪活跃租赁并管理资源使用。
该方法返回每个租赁的详细信息,包括唯一的租赁 ID、开始日期、有效期、当前状态、电话号码和租赁费用。这简化了对活跃号码的管理,并允许及时续租或结束租赁。
该方法特别适用于自动化、分析和监控系统,需要仅显示当前租赁号码,而不显示已结束会话的历史记录。
请求示例:
输入数据
| 参数 | 必填 | 备注 | 描述 |
|---|---|---|---|
| 是 | 请参见个人资料中的 API 密钥 设置 | API 密钥提供对付费服务的访问 | |
| 是 | getRentList | 方法名称 | |
| 是 | 数值 | 在请求号码时获得的租赁 ID |
服务器响应
JSON
{
"status": "success",
"values": [
{
"id": "12345",
"phone": "79181234567",
"price": "100",
"hours": "4"
},
{
"id": "12345",
"phone": "79181234568",
"price": "100",
"hours": "4"
}
]
}代码示例
const api_key = "API_KEY"; # 将 'API_KEY' 替换为您的实际 API 密钥。const id = 1; # 插入在请求号码时获得的激活 IDtry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentList&id=${id}`);# 对指定的 URL 执行 GET 请求const data = await response.json();# 输出服务器响应的内容console.log(data);} catch (err) {# 如果发生错误,输出错误消息console.error(err);}可能的错误
| 参数 | 描述 |
|---|---|
| 不正确的操作 | |
| 无效的 API 密钥 | |
| 请求错误 | |
| 账户被禁用的时间 | |
| 账户未激活 | |
| 未指定租赁 ID |