Rental API
SMSPVA / DOCUMENTATION
可用号码数量
GET /api/rent.php?method=getcount
SMSPVA API
发送 GET 请求后,检查 JSON 中的 status:1 成功,0 失败,即使 HTTP 为 200 也一样。失败原因见 msg。
身份验证
调用此方法无需 API 密钥。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "getcount" | 方法名称 |
country | query | string | 是 | "KZ" | 号码所属国家代码。 国家列表 |
dtype | query | string | 否 | "week" | 周期单位:week 或 month,省略时为 week。 |
dcount | query | integer | 否 | 1 | 周期数;dtype=week 时表示周数,省略时为 1。 |
使用说明
查询指定 country 的租赁号码余量。省略时,dtype 默认为 week,dcount 默认为 1。服务名称与价格见租赁数据,供应商明细见按供应商查询余量。
请求示例
运行环境及依赖. 示例会对查询参数编码,最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查,Java 使用 Jackson 读取 JSON。
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=getcount" \
--data-urlencode "country=KZ" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1"响应
请查看与你的请求对应的响应。数值和日期仅供示例;可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": {}
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态:1 成功,0 失败。 |
data | oneOf | 按服务划分的数量或总数,以后端响应为准。 |
msg | string | status 为 0 时的错误原因。 |