常见问题API

获取号码租赁状态

getRentStatus 方法用于通过 SMS.online API 获取租赁虚拟号码的最新状态。它可以自动化检查租赁状态的过程，并跟踪租赁号码上收到的 SMS 代码。

该方法适用于需要定期监控租赁号码的系统，以便及时接收确认代码和其他在租赁期间收到的数据。

成功的请求将返回一个对象，其中包含当前租赁状态的信息，包括租赁的唯一标识符、收到的 SMS 代码列表和租赁结束时间。这使得有效控制号码的使用和实时接收消息成为可能。

请求示例：

输入数据

参数必填备注描述
是请参见个人资料中的 API 密钥 设置API 密钥提供对付费服务的访问
是getRentStatus方法名称
是数值在请求号码时获得的激活 ID
否数值开始选择的页面编号（页面编号从 0 开始，从新到旧；默认值为 0）
否数值请求的页面数量（默认值为 10）

服务器响应

JSON
{
  "status": "success", 
  "quantity": "2", 
  "values": { 
    "0": { 
      "phoneFrom": "79180230628", 
      "text": "5", 
      "service": "ot", 
      "date": "2020-01-30 14:31:58" 
    }, 
    "1": { 
      "phoneFrom": "79180230628", 
      "text": "4", 
      "service": "ot", 
      "date": "2025-05-30 14:04:16" 
    } 
  } 
}

代码示例

const api_key = "API_KEY"; # 将 'API_KEY' 替换为您的实际 API 密钥。
const id = 1; # 插入在请求号码时获得的激活 ID
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentStatus&id=${id}`);
# 对指定的 URL 执行 GET 请求
const data = await response.json();
# 输出服务器响应的内容
console.log(data);
} catch (err) {
# 如果发生错误，输出错误消息
console.error(err);
}

可能的错误

参数描述
不正确的操作
无效的 API 密钥
请求错误
账户被禁用的时间
账户未激活
未指定租赁 ID
号码不是您租用的（无效的租赁 ID）
租赁已支付并结束
租赁已取消并退款
等待第一条短信
号码已被禁用，您的资金已退回