租用号码请求

getRentNumber 方法用于通过 SMS.online API 租用虚拟号码，租期可自定义。它可以自动化获取在指定国家和服务商接收 SMS 的号码的过程。您可以指定国家、服务商和（可选）运营商的参数，以选择可长期使用的号码。

该方法适用于需要在几天、几周或几个月内使用的固定虚拟号码的情况。这使得可以将号码集成到需要长期稳定接收 SMS 的系统中。

成功请求将返回一个包含号码信息的对象，包括其标识符、租期和费用。该方法对于需要持续访问同一号码的应用和服务特别有用，适合长期交互的场景。

请求示例：

输入数据

必填	备注	描述
是	请参见个人资料中的 API 密钥设置	API 密钥提供对付费服务的访问
是	getRentNumber	方法名称
是	请参见左侧菜单中的服务列表	需要获取号码的服务
是	请参见左侧菜单中的国家列表	需要获取号码的国家
否	请参见左侧菜单中的运营商列表	需要获取号码的移动运营商
否	4, 8, 12, 24, 72, 168, 360, 720, 2160	租赁时间（小时）
否	-	Webhook 链接（默认不考虑）

服务器响应

JSON

{ 
  "status": "success", 
  "phone": { 
    "id": 1, 
    "endDate": "2025-05-10T12:34:56", 
    "number": "79999876543"
    } 
}

代码示例

const api_key = "API_KEY"; # 将 'API_KEY' 替换为您的实际 API 密钥。
const service = "SERVICE"; # 将 'SERVICE' 替换为服务的标识符。所有标识符可以在左侧菜单的文档中查看。
const country = 1; # 插入所需国家的号码。所有国家的号码可以在左侧菜单的文档中查看。
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentNumber&service=${service}&country=${country}`);
# 对指定的 URL 执行 GET 请求
const data = await response.json();
# 输出服务器响应的内容
console.log(data);
} catch (err) {
# 如果发生错误，输出错误消息
console.error(err);
}

可能的错误

参数	描述
	不正确的操作
	无效的 API 密钥
	请求错误
	账户被禁用的时间
	账户未激活
	不正确的国家名称
	不正确的服务名称
	不正确的时间
	未找到余额
	没有可用的号码
	账户已被禁用

租用号码请求

输入数据

服务器响应

代码示例

可能的错误

购买号码