Collapse content

API —  Bu, yazılımınızla aktivasyon sunucumuz arasındaki etkileşim protokolüdür. Yanınızda sms mesajları alma sürecini otomatikleştirmek için API'ye ihtiyacınız var

Apı'miz sms-activate API ile uyumludur

Tüm isteklerde apı_key parametresi şeklinde bir API anahtarı bulunmalıdır

API activations
API: Numara isteği

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country

&action=getNumber
$api_key — API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın).
$service — servis kodu. Servis Kodları bölümüne bakın.
$country — ülke kodu. «Ülke Kodları» bölümüne bakın. Belirtilmediyse, varsayılan olarak Rusya numarası seçilecektir.

Olası hatalar:
BAD_KEY — geçersiz API anahtarı;
NO_NUMBERS — numara yok; numara verilmedi — talebi tekrarlayın veya başka bir ülke seçin.

Başarılı bir yanıt örneği:

ACCESS_NUMBER:38496653:66846426435

Burada 38496653 aktivasyon id ve 66846426435 telefon numarasıdır.

API activations
API: Etkinleştirme durumundaki değişiklikler

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

&action=setStatus
$api_key — API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın).
$id — aktivasyon id;
$status — aktivasyon durumu:
-1 - aktivasyonu iptal et;
1 — numaranın hazır olduğunu bildirin (numaraya sms gönderildi);
3 — Aynı numaraya yeni bir kod beklendiğini bildirin;
6 — aktivasyonu sonlandırın;
8 - aktivasyonu iptal edin.

Hizmetin yanıtları:
ACCESS_READY - numaranın hazır olduğu doğrulandı;
ACCESS_RETRY_GET - yeni sms bekleniyor;
ACCESS_ACTİVATİON - Hizmet başarıyla etkinleştirildi;
ACCESS_CANCEL - etkinleştirme iptal edildi.


Olası hatalar:
ERROR_SQL - SQL sunucusu hatası;
NO_ACTİVATİON - Aktivasyon kimliği mevcut değil;
BAD_SERVİCE - hizmetin yanlış adı;
BAD_STATUS - yanlış durum;
BAD_KEY - Geçersiz API Anahtarı;
BAD_ACTİON yanlış bir eylemdir.

API activations
API: Kodu veya etkinleştirme durumunu alın

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

&action=getStatus
$api_key — API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın).
$id — aktivasyon id;

Hizmetin yanıtları:
STATUS_WAİT_CODE - sms bekleniyor
STATUS_WAİT_RETRY:$lastcode - kodun açıklığa kavuşturulması bekleniyor (burada $lastcode geçmiş, geçmiş olmayan koddur)
STATUS_WAİT_RESEND - sms'in yeniden gönderilmesini bekliyor —yazılım sms'i yeniden gönder'e basmalı ve durumu 6 olarak değiştirmelidir)
STATUS_CANCEL - Etkinleştirme iptal edildi
STATUS_OK:$code - kod alındı (burada $code — aktivasyon kodu)

Olası hatalar:
NO_ACTİVATİON - Aktivasyon id mevcut değil
BAD_KEY - Geçersiz API Anahtarı
BAD_ACTİON - yanlış eylem

API activations
API: Bakiye sorgulama

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key — API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın).

Hizmetin yanıtı:

ACCESS_BALANCE:$balance

Olası hata:

BAD_KEY — Geçersiz API anahtarı

API activations
API: Ülkeye göre güncel fiyatları alın

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&action=getPrices
$api_key — API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın).
$service — servis kodu. Servis Kodları bölümüne bakın;
$country — ülke kodu. Belirtilmediyse, varsayılan olarak Rusya numarası seçilecektir. «Ülke Kodları» bölümüne bakın.


Hizmetin yanıtları formatta

{
  "Ülke": {
    "Servis": {
      "cost": Maliyet,
      "count": Sayı
    }
  }
}

 

API rent
API: Kiralık numara talebi

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&country=$country&rent_time=$time

$apı_key - API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın);
$service - Hizmet kodu ("Hizmet Kodları" bölümüne bakın);
$countryülke kodudur. Belirtilmediyse, varsayılan olarak Rusya numarası seçilecektir ("Ülke Kodları" bölümüne bakın);
$time - bir saatlik kiralama süresi (en az 4 saat).

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü",
  "phone": {
    "id": ”id kiralama”,
    “endDate”: ”kiralamanın tamamlanma tarihi”,
    “number”:”telefon numarası”
  }
}

 

Başarılı bir yanıt örneği:

{
  "status": "success",
  "phone": {
    "id": ”38496653”,
    “endDate”: ”2023-12-31T19:30:52”,
    “number”: ”66846426435”
  }
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error": "BAD_KEY"
}

 

Olası hatalar:
BAD_KEY - Hatalı API anahtarı;
BAD_COUNTRY - yanlış ülke kodu;
BAD_SERVİCE - hatalı servis kodu;
INVALİD_TİME - yanlış saat sayısı;
NO_BALANCE - hesapta yeterli nakit yok;
NO_NUMBERS - numara yok; numara verilmedi – talebi tekrarlayın veya başka bir ülke seçin;
SERVER_ERROR - Sunucu hatası, isteği daha sonra tekrarlayın.

API rent
API: Kiralamayı yenileyin

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

$api_key - API anahtarınız (Kişisel Hesabınızdaki Ayarlar bölümüne bakın);
$time - kiralama süresi bir saattir (en az 4 saat).

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü",
  "phone": {
    "id": ”id kiralama”,
    “endDate”: ”kiralamanın tamamlanma tarihi”,
    “number”: ”telefon numarası”
  }
}

Başarılı bir yanıt örneği:

{
  "status": "success",
  "phone": {
    "id": ”38496653”,
    “endDate”: ”2023-12-31T19:30:52”,
    “number”: ”66846426435”
  }
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error":"BAD_KEY"
}

 

Olası hatalar:
BAD_KEY - Hatalı API anahtarı;
INVALİD_TİME - yanlış saat sayısı;
NO_İD_RENT - yanlış kiralama kimliği;
NO_BALANCE - hesapta yeterli nakit yok;
RENT_DİE - Bu numara artık kullanılamıyor, yeni numarayı seçin;
SERVER_ERROR - Sunucu hatası, isteği daha sonra tekrarlayın.

API rent
API: Kiralama geçmişi

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentHistory&id=$id

$api_key – API anahtarınız (Kişisel Hesabınızdaki Ayarlar bölümüne bakın);
$id – kira kimliği;

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü",
  "quantity": "kiralama sayısı",
  "values": {
    “1”: {
      “date”: ”kiralama başlangıç tarihi”,
      “price”: kira bedeli,
      “hours”:Kiralama süresi
    }
  }

 

Başarılı bir yanıt örneği:

{
  "status": "success",
  "quantity": ”2”,
  "values": {
    “1”: {
      “date”: ”2023-10-26 11:03:39”,
      “price”: 3.6,
      “hours”: 4
    },
    “2”: {
      “date”:” 2023-10-25 11:02:31”,
      “price”: 4,
      “hours”: 5
    }
  }
}

 

Boş miktarla başarılı bir yanıt örneği:

{
  "status": "success",
  "values": {}
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error": "SQL_ERROR"
}

 

Olası hatalar:
BAD_KEY - Hatalı API anahtarı;
NO_İD_RENT - yanlış kiralama kimliği;
SQL_ERROR - SQL sunucu hatası, sorguyu daha sonra tekrarlayın.

API rent
API: Kiralama durumunu değiştirme

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

$apı_key - API anahtarınız (Hesabınızdaki Ayarlar bölümüne bakın);
$id – kira kimliği;
$status - kiralama durumu:
1 – kiralamayı tamamlayın;
2 - kirayı iptal edin.

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü"
}

 

Başarılı bir yanıt örneği:

{
  "status": "success"
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error": "CANT_CANCEL"
}

 

Olası hatalar:
BAD_KEY - Hatalı API anahtarı;
NO_İD_RENT - yanlış kiralama kimliği;
INVALİD_PHONE - kira kimliği mevcut değil;
INCORECT_STATUS - yanlış kiralama durumu;
ALREADY_FİNİSH - Kiralama işlemi tamamlandı;
ALREADY_CANCEL - Kiralama iptal edildi;
CANT_CANCEL - iptal edilemiyor (SMS alındı veya 20 dakika geçti);
SQL_ERROR - SQL sunucu hatası, sorguyu daha sonra tekrarlayın;
SERVER_ERROR - Sunucu hatası, isteği daha sonra tekrarlayın.

API rent
API: Kod listesini veya kiralama durumunu alın

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id

$api_key – API anahtarınız (Kişisel Hesabınızdaki Ayarlar bölümüne bakın);
$id – Kiranın id.

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü",
  "quantity": "kod sayısı",
  "values": {
     "0": {
       "phoneFrom": "telefon numarası",
       "service": "servis kodu",
       "text": "servis kodu",
       "date": "sms'in alındığı tarih"
    }
  }
}

 

Başarılı bir yanıt örneği:

{
  "status": "success",
  "quantity": "2 ",
  "values": {
    "0 ": {
      "phoneFrom": "66846426435",
      "service": "tg",
      "test": "123456",
      "date": "2023-10-26 11:03:39"
    },
    "1": {
      "phoneFrom ": "66846426435",
      "service": "tg",
      "test": "224444",
      "date": "2023-10-26 11:02:31"
    }
  }
}

 

Boş kod listesi ile başarılı yanıt örneği:

{
  "status": "success",
  "values":{}
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error": "NO_ID_RENT"
}

 

Olası hatalar:
BAD_KEY – Hatalı API anahtarı;
NO_ID_RENT – yanlış kiralama kimliği;
INVALID_PHONE – kira id mevcut değil;
SERVER_ERROR – Sunucu hatası, isteği daha sonra tekrarlayın.

API rent
API: Ülkeye göre güncel kiralama fiyatlarını alın

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentPrices&service=$service&country=$country&rent_time=$time

$api_key – API anahtarınız (Kişisel Hesabınızdaki Ayarlar bölümüne bakın);
$service – hizmet kodu ("Hizmet Kodları" bölümüne bakın);
$country – ülke kodu. Belirtilmediyse, varsayılan olarak Rusya numarası seçilecektir ("Ülke Kodları" bölümüne bakın);
$time - kiralama süresi bir saattir (en az 4 saat).

Hizmetin yanıtı json biçiminde olacaktır:

{
  "status": "Statü",
  "values": {
    "Страна": {
      "Сервис": {
        "cost": Maliyet,
        "count": Sayı,
        "max_hours": Maksimum Kiralama Saatleri
      }
    }
  }
}

 

Başarılı bir yanıt örneği:

{
  "status": "success",
  "values": {
    "0": {
      "tg": {
        "cost": 12,
        "max_hours": 10,
        "count": 15
      }
    }
  }
}

 

Hatalı yanıt örneği:

{
  "status": "error",
  "error": "INVALID_TIME"
}

 

Olası hatalar:
BAD_KEY – hatalı API anahtarı;
BAD_COUNTRY – yanlış ülke kodu;
BAD_SERVICE – hatalı servis kodu;
INVALID_TIME – yanlış saat sayısı;
NO_NUMBERS – numara yok; numara verilmedi – talebi tekrarlayın veya başka bir ülke seçin;
SERVER_ERROR – sunucu hatası, isteği daha sonra tekrarlayın.