VavSMS

API Dokümantasyonu

SMS onay ve kiralık numara servislerini REST API ile otomatikleştirin.

Son güncelleme: 15 Aralık 2025

Giriş

Bu dokümantasyon, hem Tekil SMS hem de numara kiralama servisleri için siparişlerinizi otomatikleştirmek üzere API'mizi nasıl kullanacağınızı açıklar.

Temel URL

Tüm API istekleri şu adrese yapılmalıdır:

https://vavsms.com/api

Kimlik Doğrulama

API anahtarınızı aşağıdaki örneklerde gösterildiği gibi URL'ye ekleyin. API anahtarınızı profil sayfanızda bulabilirsiniz.

Tekil SMS Servisi

GET /getCategories

Kategorileri Listele

Tekil SMS servisleri için mevcut kategorilerin listesini döndürür.

Yanıt

[
  {
    "id": 1,
    "name": "Google/Youtube",
    "cheapest": 0.30,
    "maxRate": 75
  },
  ...
]
GET /getServices/{category_id}

Kategoriye Göre Servisleri Listele

Belirtilen kategori için mevcut servislerin listesini döndürür.

Parametre Tür Açıklama
category_id integer Kategorinin ID'si

Yanıt

[
  {
    "id": 1,
    "name": "United States",
    "price": 1.20,
    "workRate": 25,
    "category": "Google/Youtube"
  },
  ...
]
GET /getServiceDetails/{service_id}

Servis Detaylarını Getir

Belirli bir servisin fiyat ve stok bilgisini döndürür.

Parametre Tür Açıklama
service_id integer Servisin ID'si

Yanıt

{
  "id": 1,
  "price": 1.20,
  "stock": 250
}
GET /{api_key}/getBalance

Kullanıcı Bakiyesini Getir

Kullanıcının güncel bakiyesini döndürür.

Parametre Tür Açıklama
api_key string API anahtarınız

Yanıt

{
  "balance": 30
}
GET /{api_key}/getNumber/{service_id}

Yeni Numara Sipariş Et

Belirtilen servis için yeni bir numara sipariş eder.

Parametre Tür Açıklama
api_key string API anahtarınız
service_id integer Servisin ID'si

Yanıt

{
  "success": true,
  "message": "Number purchased successfully.",
  "number_id": 10001,
  "number": "+18887776655"
}
Not: number_id ve number değerlerini saklayın; mesajları okumak için bunlara ihtiyacınız olacak.
GET /{api_key}/getMessage/{number_id}

Gelen Mesajı Getir

Belirtilen numara için gelen mesajı getirir.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Numaranın ID'si

Yanıt

{
  "code": "888777",
  "text": "G-888777 is your Google verification code.",
  "id": "10001",
  "status": 0
}

Durum kodları: 0 = Mesaj bekleniyor, 1 = Mesaj alındı (kod gösterildi), -1 = Numara iptal edildi

GET /{api_key}/cancelNumber/{number_id}

Numarayı İptal Et

Belirtilen numarayı iptal eder. 10 dakika içinde iptal edilirse bakiye iade edilir.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Numaranın ID'si

Yanıt

{
  "success": true,
  "message": "Number canceled and balance refunded."
}

Numara Kiralama Servisi

GET /getRentCountries

Kiralık Ülkeleri Getir

Numara kiralama için mevcut ülkelerin listesini döndürür.

Yanıt

[
  {"id": 0, "name": "Russia"},
  ...
]
GET /getRentServices/{country_id}/{time}

Kiralık Servisleri Getir

Belirli bir ülke ve kiralama süresi için mevcut kiralık servislerin listesini getirir.

Parametre Tür Açıklama
country_id integer Ülkenin ID'si (Kiralık Ülkeleri Getir'den alınır)
time integer Saat cinsinden kiralama süresi (4, 12 veya 24'ün katları, en fazla 672)

Yanıt

[
  {
    "id": "go",
    "name": "Google",
    "stock": {"current": 10, "total": 20},
    "price": 1.50
  },
  ...
]
GET /getRentNumber/{api_key}/{country_id}/{service_id}/{time}

Kiralık Numara Sipariş Et

Belirtilen servis ve ülke için bir numara kiralar.

Parametre Tür Açıklama
api_key string API anahtarınız
country_id integer Ülkenin ID'si
service_id string Servisin ID'si
time integer Saat cinsinden kiralama süresi

Yanıt

{
  "success": true,
  "number_id": 100,
  "number": "+18887776655"
}
Not: number_id değerini saklayın; mesajları okumak için buna ihtiyacınız olacak.
GET /getRentActivations/{api_key}

Kiralık Aktivasyonları Getir

Kullanıcının aktif kiralık numaralarının listesini döndürür.

Parametre Tür Açıklama
api_key string API anahtarınız

Yanıt

{
  "success": true,
  "number_id": 100,
  "number": "+79998887766"
}
GET /getRentMessage/{api_key}/{number_id}

Kiralık Mesajı Getir

Belirtilen kiralık numara için gelen mesajları getirir.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Kiralık numaranın ID'si

Yanıt

{
  "id": 100,
  "number": "+18887776655",
  "service": "Google",
  "country_id": 0,
  "message": [
    {
      "from": "+15559876543",
      "message": "Your verification code is 123456",
      "time": 1625097600
    }
  ],
  "msgcount": 1,
  "start_time": 1625097000,
  "end_time": 1625183400
}
GET /cancelRentNumber/{api_key}/{number_id}

Kiralık Numarayı İptal Et

Belirtilen kiralık numarayı iptal eder. 20 dakika sonra veya SMS geldiyse iptal edilemez.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Kiralık numaranın ID'si

Yanıt

{
  "success": true,
  "message": "Number has been cancelled successfully. Your money has been refunded to your account."
}
GET /getRentRenewPrice/{api_key}/{number_id}/{time}

Kiralık Yenileme Fiyatını Getir

Kiralık bir numarayı yenilemenin fiyatını döndürür.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Kiralık numaranın ID'si
time integer Yenileme süresi (opsiyonel)

Yanıt

{
  "success": true,
  "price": 0.50,
  "number": "+79998887766"
}
GET /renewRentNumber/{api_key}/{number_id}/{time}

Kiralık Numarayı Yenile

Belirtilen kiralık numarayı yeniler.

Parametre Tür Açıklama
api_key string API anahtarınız
number_id integer Kiralık numaranın ID'si
time integer Yenileme süresi (opsiyonel)

Yanıt

{
  "success": true,
  "message": "Number has been renewed successfully."
}

Hata Yönetimi

API, isteklerin başarılı veya başarısız olduğunu belirtmek için HTTP yanıt kodları kullanır. Yaygın hata kodları:

  • 200: Başarılı
  • 400: Hatalı İstek
  • 401: Yetkisiz
  • 404: Bulunamadı
  • 500: Sunucu Hatası

Hata ayıklama amacıyla yanıt gövdesinde ayrıntılı hata mesajları yer alabilir.

İstek Sınırı

API'miz IP adresi başına 10 saniyede 100 istekle sınırlıdır. Sınırın aşılması 1 dakikalık IP engellemesine yol açar.

Destek

API hakkında ek destek veya sorularınız için lütfen destek sistemi üzerinden bizimle iletişime geçin.

Ülke
167
Sanal Numaralar
4.340.475
Destek Talebi
281