Rental API
SMSPVA / DOCUMENTATION
按供应商查询租赁数据
GET /api/rent.php?method=getdataWithProviders
SMSPVA API
发送 GET 请求后，检查 JSON 中的 status：1 成功，0 失败，即使 HTTP 为 200 也一样。失败原因见 msg。
身份验证
apikey 查询参数可选。公共数据可省略；按文档传入后可获取账户相关数据或价格。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "getdataWithProviders" | 方法名称 |
apikey | query | string | 否 | (optional) | 可选 API 密钥，传入后可能影响账户相关租赁数据及价格。 |
country | query | string | 是 | "KZ" | 号码所属国家代码。 国家列表 |
dtype | query | string | 否 | "week" | 周期单位：week 或 month，省略时为 week。 |
dcount | query | integer | 否 | 1 | 周期数；dtype=week 时表示周数，省略时为 1。 |
extend | query | string | 否 | "1" | 启用扩展响应格式的可选标记。 |
使用说明
比较指定 country 的可用服务、日价及供应商余量。dtype 和 dcount 应与实际租期一致。
国家代码见租赁国家。选好服务后，用其代码创建租赁或创建多服务租赁。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
# Optional: add --data-urlencode "apikey=$SMSPVA_API_KEY" for account-specific data.
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=getdataWithProviders" \
--data-urlencode "country=KZ" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": {
"services": [
{
"name": "1cupis & okcupid & winline",
"service": "opt48",
"price_day": 5,
"img": "images/ico/cupis_okcupid_winline.ico",
"procent_days": 0,
"procent": 0,
"day_step": 0,
"count": {
"Claro_AR": 27
},
"totalCount": 12
}
],
"totalAmount": 1735,
"allOperators": [
"Claro_AR"
]
}
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态：1 成功，0 失败。 |
data | object | |
data.services | array<object> | |
data.services[].name | string | 服务名称 |
data.services[].service | string | 服务代码 服务列表 |
data.services[].price_day | number | 该服务的日价 |
data.services[].img | string | 服务图标 URL |
data.services[].procent_days | integer | 适用折扣的天数 |
data.services[].procent | integer | 折扣百分比 |
data.services[].day_step | integer | 计价天数步长 |
data.services[].count | object | 该服务在各运营商的可用号码数量 |
data.services[].count.* | integer | |
data.services[].totalCount | integer | 该服务的可用号码总数 |
data.totalAmount | integer | 全部服务的可用号码总数 |
data.allOperators | array<string> | 该国家全部可用运营商 |
msg | string | status 为 0 时的错误原因，此时 HTTP 仍可能为 200。 |