VioSMS Açık API

Kimlik Doğrulama

API isteklerinizi doğrulamak için Authorization HTTP başlığına gizli API anahtarınızı ekleyin.

HTTP Header

Authorization: Bearer YOUR_API_KEY

GET/api/v1/balance

Mevcut hesap bakiyenizi döndürür.

Yanıt

{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}

GET/api/v1/services

Mevcut tüm servislerin bir listesini ve minimum fiyatlarını döndürür.

Not: Eğer Hinge veya Tinder gibi belirli bir servis arıyorsanız, sistemdeki tüm dinamik servis kodlarını bulmak için bu endpoint'i kullanın.

Yanıt

{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}

GET/api/v1/countries

Mevcut tüm ülkelerin ve kodlarının bir listesini alın. Bir numara satın alırken bu yanıttaki code değerini kullanmalısınız.

Yanıt

{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}

POST/api/v1/buy

Yeni bir telefon numarası satın alır. Ücret bakiyenizden düşülür.

Parametre	Numara satın alma ve onaylama işlemlerini otomatikleştirmek için VioSMS API'sini uygulamalarınıza entegre edin. Tüm API istekleri için bir API Anahtarı gerekir.
servicestring*	Servis kodu (örn. WhatsApp için "wa").
countrystring*	Ülke kodu (örn. Türkiye için "161").
operatorstring	İsteğe bağlı operatör kodu. Varsayılan "any".

İstek

{
  "service": "wa",
  "country": "161"
}

Yanıt

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}

GET/api/v1/status

Bir aktivasyonun SMS onay durumunu kontrol eder.

Parametre	Numara satın alma ve onaylama işlemlerini otomatikleştirmek için VioSMS API'sini uygulamalarınıza entegre edin. Tüm API istekleri için bir API Anahtarı gerekir.
idstring*	Satın alma işleminden dönen benzersiz Aktivasyon ID'si.

Yanıt

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}

POST/api/v1/cancel

Eğer SMS alınmadıysa bir aktivasyonu iptal eder ve ücreti iade eder.

Parametre	Numara satın alma ve onaylama işlemlerini otomatikleştirmek için VioSMS API'sini uygulamalarınıza entegre edin. Tüm API istekleri için bir API Anahtarı gerekir.
idstring*	İptal edilecek benzersiz Aktivasyon ID'si.

İstek

{
  "id": "cuid..."
}

Yanıt

{
  "status": "success",
  "message": "Activation cancelled and refunded"
}