Rental API
SMSPVA / DOCUMENTATION
创建多服务租赁
GET /api/rent.php?method=create_multi
SMSPVA API
发送 GET 请求后，检查 JSON 中的 status：1 成功，0 失败，即使 HTTP 为 200 也一样。失败原因见 msg。
此请求可能修改租赁订单或产生费用。响应丢失后，先查询订单及历史，再决定是否重试：更改可能已经生效。示例不会自动重试。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "create_multi" | 方法名称 |
apikey | query | string | 是 | SMSPVA_API_KEY | 你的 API 密钥 可在网站右上角菜单的 Profile and APIKEY 中找到。 |
dtype | query | string | 是 | "week" | 周期单位：week 或 month |
dcount | query | integer | 是 | 1 | 周期数；dtype=week 时表示周数。 |
country | query | string | 是 | "KZ" | 号码所属国家代码。 国家列表 |
services | query | string | 是 | "opt6,opt7,opt8" | 逗号分隔的服务代码。 服务列表 |
provider | query | string | 否 | "T-Mobile" | 可选供应商名称；省略时，从可用供应商中随机选择。 |
partner_key | query | string | 否 | "partnerkeyhere" | 可选的推荐合作方密钥。 |
使用说明
为多个服务租赁同一个号码。在 services 中传入逗号分隔的服务代码，并先检查多服务余量。
先选择国家，按相同国家和租期比较服务、供应商及价格。创建后，在租赁订单中找到订单，并在发送短信前激活。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=create_multi" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1" \
--data-urlencode "country=KZ" \
--data-urlencode "services=opt6,opt7,opt8"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": {
"id": 40370,
"pnumber": "9096037108",
"ccode": "+7",
"service": "opt6",
"until": "1587633960"
}
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态：1 成功，0 失败。 |
data | object | |
data.id | integer | 订单 ID |
data.pnumber | string | 不含国家区号的电话号码 |
data.ccode | string | 数字国家代码 |
data.service | string | 服务代码 服务列表 |
data.until | string | 到期时间（Unix 时间戳） |
msg | string | status 为 0 时的错误原因。 |