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.