VioSMS 公共 API

将 VioSMS 集成到您的应用程序中以自动购买和验证号码。所有 API 接口均需要 API 密钥。

身份验证

通过在 Authorization HTTP 标头中包含您的秘密 API 密钥来验证您的 API 请求。

HTTP Header
Authorization: Bearer YOUR_API_KEY
GET/api/v1/balance

返回您当前的账户余额。

响应
{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}
GET/api/v1/services

返回所有可用服务及其最低价格的列表。

注意: 如果您正在寻找特定服务（如 Hinge 或 Tinder），请使用此端点动态获取所有可用的服务代码。

响应
{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}
GET/api/v1/countries

检索所有可用国家/地区及其代码的列表。购买号码时，您必须使用此响应中的 code。

响应
{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}
POST/api/v1/buy

购买新的电话号码。费用将从您的余额中扣除。

参数将 VioSMS 集成到您的应用程序中以自动购买和验证号码。所有 API 接口均需要 API 密钥。
servicestring*

服务代码（例如 WhatsApp 的 "wa"）。

countrystring*

国家代码（例如土耳其的 "161"）。

operatorstring

可选的运营商代码。默认为 "any"。

请求
{
  "service": "wa",
  "country": "161"
}
响应
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}
GET/api/v1/status

检查激活的短信验证状态。

参数将 VioSMS 集成到您的应用程序中以自动购买和验证号码。所有 API 接口均需要 API 密钥。
idstring*

购买接口返回的唯一激活 ID。

响应
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}
POST/api/v1/cancel

如果没有收到短信，则取消激活并退还费用。

参数将 VioSMS 集成到您的应用程序中以自动购买和验证号码。所有 API 接口均需要 API 密钥。
idstring*

要取消的唯一激活 ID。

请求
{
  "id": "cuid..."
}
响应
{
  "status": "success",
  "message": "Activation cancelled and refunded"
}