Rental API
SMSPVA / DOCUMENTATION
向订单添加服务
GET /api/rent.php?method=add_service_to_order
SMSPVA API
发送 GET 请求后，检查 JSON 中的 status：1 成功，0 失败，即使 HTTP 为 200 也一样。失败原因见 msg。
此请求可能修改租赁订单或产生费用。响应丢失后，先查询订单及历史，再决定是否重试：更改可能已经生效。示例不会自动重试。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "add_service_to_order" | 方法名称 |
apikey | query | string | 是 | SMSPVA_API_KEY | 你的 API 密钥 可在网站右上角菜单的 Profile and APIKEY 中找到。 |
id | query | integer | 是 | 56547 | 订单 ID |
service | query | string | 是 | "opt89" | 服务代码 服务列表 |
pnumber | query | string | 是 | "79335445295" | 租赁号码，含国家区号，不带 +。 |
rent_days | query | integer | 否 | 7 | 可选租赁天数；省略时，多数国家默认 7 天，加拿大默认 1 天。 |
使用说明
为已有租赁添加服务。在租赁订单中获取 ID 和 pnumber，再按该国家查询供应商数据，确认新服务及价格。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
SMSPVA_RENTAL_ORDER_ID: id.SMSPVA_RENTAL_NUMBER:pnumber.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_RENTAL_ORDER_ID:?Set SMSPVA_RENTAL_ORDER_ID}"
: "${SMSPVA_RENTAL_NUMBER:?Set SMSPVA_RENTAL_NUMBER}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=add_service_to_order" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID" \
--data-urlencode "service=opt89" \
--data-urlencode "pnumber=$SMSPVA_RENTAL_NUMBER" \
--data-urlencode "rent_days=7"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": {
"id": 4211321,
"pnumber": "37067181111",
"service": "opt95",
"until": 1771583220
}
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态：1 成功，0 失败。 |
data | object | 新增服务详情 |
data.id | integer | 订单 ID |
data.pnumber | string | 电话号码 |
data.service | string | 服务代码 服务列表 |
data.until | integer | 服务到期时间（Unix 时间戳） |