- Главная
- API
API Grizzly SMS
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
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.
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.
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
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ı
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ı
}
}
}
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.
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.
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.
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.
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.
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.