Grizzly CMS iş ortağı API belgeleri

Protokolün Çalışma Açıklaması

Ortak protokolü, telefon numaraları ve gelen SMS mesajlarını API aracılığıyla doğrudan Grizzly SMS sunucusuna sağlamak için tasarlanmıştır. 

Tüm istekler — KEY parametresini içerir. Bu anahtar, destek personeli tarafından sağlanır ve kişisel hesapta mevcuttur.

Miktar istekleri GET_SERVICES, numara istekleri GET_NUMBER ve aktivasyon tamamlama istekleri FINISH_ACTIVATION doğrudan bizim sunucumuzdan ortağın sunucusuna gönderilir.

URL formatı : https://GrizzlySMS burada GrizzlySMS partner.ru:port/GrizzlySMS.php veya partner.ru/GrizzlySMS.php olabilir

GET_SERVICES

GET_NUMBER

PUSH_SMS

FINISH_ACTIVATION

Grizzly SMS sunucusu, telefon numaralarının miktarını GET_SERVICES yöntemiyle yaklaşık her 10-20 saniyede bir istek gönderir.

Yanıtta > 0 adet sağlarsanız, GET_NUMBER yöntemiyle telefon numarası verme isteği alırsınız.

GET_NUMBER isteğini aldıktan sonra, tüm kriterleri karşılayan bir 
telefon numarası sağlamanız ve gelen tüm SMS mesajlarını PUSH_SMS yöntemiyle bize iletmeniz gerekmektedir. Bu, bizim net ve objektif filtreleme yapabilmemiz ve ilgili SMS mesajlarını müşterilerimiz için doğru servise iletebilmemiz için gereklidir.

Telefon numaralarıyla ilgili tüm gerekli görevleri tamamladığınızda, FINISH_ACTIVATION yöntemiyle durum 3 alacaksınız. Bu durum, telefon numarasının başarıyla kaydedildiğini ve bunun için ödüllendirildiğinizi belirtir.

Gereksinimler:

  • İstek/yanıt formatı: JSON
  • UTF-8 kodlaması
  • Grizzly SMS sunucusuna yapılan isteklerde her zaman bir user-agent başlığı kullanın

 

Alan türleri:

  • int : -2 147 483 648 ile 2 147 483 647 arasında tamsayı değeri
  • Uint : 0 ile 2 147 483 647 arasında işaretsiz tamsayı değeri
  • long : -9 223 372 036 854 775 808 ile 9 223 372 036 854 775 807 arasında tamsayı değeri
  • Ulong : 0 ile 9 223 372 036 854 775 807 arasında işaretsiz uzun tamsayı değeri
  • cur : örneğin 177.77 gibi, en fazla 2 ondalık basamak içeren gerçek değer
  • boolean : true veya false değişmez değerleri
  • string : sınırsız uzunlukta dize değeri
  • array of string: dize dizisi
1. GET_SERVICES Numara İsteği Yöntemi

Bu istek, satışa sunulan hizmetler için mevcut telefon numaralarının adet bilgilerini bize sağlar.

POST isteği, Grizzly SMS sunucusundan ortağın sunucusuna iletilir.

! Lütfen dikkat: GSM modeminiz eşzamanlı aktif modül sayısında sınırlıysa, aktif modül sayısına eşit bir adet sağlamalısınız.

İstek Alanları
Alan Tür Gerekli Açıklama
action String
 
 GET_SERVICES
key String
 
 Protokol anahtarı
Yanıt Alanları:
Alan Tür Gerekli Açıklama
status String
 
 Yanıtın durumu (bkz. Durum Tablosu)
countryList Array of CountryList
 
 Ülke listesi
 
CountryList
Alan Tür Gerekli Açıklama
country Number
 
 (bkz. Veri Tablosu)
operatorMap* İlişkisel
dizi
 
 Anahtar - operatör (bkz. Veri Tablosu), değer - hizmetlerin ilişkisel dizisi**

* operatorMap içinde boş veri dizileri göndermemelisiniz

** Hizmetlerin ilişkisel dizisi: Anahtar - kısa hizmet adı (bkz. Veri Tablosu), değer - hizmet için mevcut telefon numaralarının adedi (tür: int)

İstek örneği:
{
  "action": "GET_SERVICES",
  "key": "qwerty123"
}
Yanıt örneği:
{
  "countryList":
    [
      {
        "country": 12,
        "operatorMap":
          {
            "any":
              {
                "tg": 3,
                "wa": 10
              }
          }
      },
      {
        "country": 187,
        "operatorMap":
          {
            "any":
              {
                "tg": 0,
                "wa": 32
              }
          }
      }
    ],
  "status": "SUCCESS"
}
2. GET_NUMBER İstek Yöntemi

This request provides us with a phone number that we pass on to the client.

The POST request is transmitted from the Grizzly SMS server to the partner's server.

If the exceptionPhoneSet array contains a list of prefixes, for example 44742 and 44740, you should not provide a number that starts with any of these prefixes. The number of digits is not limited by the size of the prefix.

Request fields:
Field Type Required Desctiption
action String
 
 GET_NUMBER
key String
 
 Protocol key
country Number
 
 see Data Table
service String
 
 see Data Table
operator String
 
 see Data Table
sum Cur
 
 The amount you will receive for a successfully registered service

exceptionPhoneSet

 Array of String
 
 List of prefixes that are PROHIBITED to give when requesting a phone number
canGetAnotherSms Boolean
or int/uint		   Flag that shows if an additional SMS can be received:
0/1, true/false or "true"/"false"
Answer fields
Field Type Required Description
status String
 
 (see Status Table)
number Ulong
 
 Phone number with country code
activationId Ulong
 
 Activation ID in the partner's system
flashcall Boolean   TRUE if support PUSH_CALL
voice Boolean   TRUE if support PUSH_CALL_RECORD
canGetAnotherSms Boolean
or int/uint		   Flag that shows if an additional SMS can be received:
0/1, true/false or "true"/"false"
 
İstek örneği:
{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": 12,
  "operator": "any",
  "service": "tg",
  "sum": 20.00,
}
ExceptionPhoneSet içeren istek örneği
{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": 12,
  "operator": "any",
  "service": "tg",
  "sum": 10,
  "exceptionPhoneSet": [
    "1234",
    "12345"
  ]
}
Yanıt örneği:
{
  "status": "SUCCESS",
  "number": 19157891133,
  "activationId": 571346,
  "flashcall": true,
  "voice": false,
  "canGetAnotherSms": true
}
Numara bulunmaması durumunda yanıt örneği:
{
  "status": "NO_NUMBERS"
}
3. PUSH_SMS Yöntemi Kullanılarak SMS'in Grizzly SMS Sunucusuna İletilmesi

Bu POST isteği, ortağın sunucusundan Grizzly SMS sunucusuna şu adrese gönderilir:  https://api.grizzlysms.com/agent/api/sms

"SUCCESS" durumlu bir yanıt alırsanız, SMS'i veritabanınızda başarıyla teslim edildi olarak işaretleyin ve tekrar göndermeyin. "SUCCESS" dışındaki bir durum döndürülürse, "SUCCESS" durumu alana kadar isteği 10 saniye gecikmeyle tekrarlayın.

İstek Alanları
Alan Tür Gerekli Açıklama
action String
 
 PUSH_SMS
key String
 
 Protokol anahtarı
smsId Ulong
 
 Ortağın sistemindeki SMS ID'si
phone Ulong
 
 SMS'in gönderildiği telefon numarası (ülke kodu dahil)
phoneFrom String
 
 SMS'i gönderen alıcı adı (alfanümerik veya sayısal olabilir)
Text String
 
 SMS metni
Yanıt Alanları
Alan Tür Gerekli Açıklama

status

 String
 
 (bkz. Durum Tablosu)
İstek örneği:
{
  "action": "PUSH_SMS",
  "key": "qwerty123",
  "smsID": 1
  "phone": 447472190082
  "phoneFrom": "Microsoft",
  "text": "Microsoft access code: 5015"
}
Yanıt örneği:
{
  "status": "SUCCESS"
}
4. Aktivasyon Tamamlama İstek Yöntemi FINISH_ACTIVATION

Bu istek, aktivasyonu tamamlamak için Grizzly SMS sunucusundan ortağın sunucusuna iletilir.

Grizzly SMS sunucusundan ortağın sunucusuna başlatılan POST isteği.

Aktivasyon yönetimi Grizzly SMS tarafından tamamen kontrol edilir. Kontrolümüz dışındaki faktörler nedeniyle, başarılı durum değişikliği regarding yanıtınızı alamayabiliriz. Bu nedenle, Grizzly SMS tekrarlanan aktivasyon tamamlama isteği gönderirse, aktivasyon ID'sinin sizin tarafınızda var olup olmadığını kontrol etmelisiniz. Aktivasyon mevcutsa, yanıt olarak SUCCESS durumu gönderin.

İstek Alanları
Alan Tür Gerekli Açıklama
action String
 
 FINISH_ACTIVATION
key String
 
 Protokol anahtarı
activationId Ulong
 
 İkinci istekte alınan Aktivasyon ID'si
status Ulong
 
 Bkz. Durum Tablosu
Yanıt Alanları
Alan Tür Gerekli Açıklama

status

 String
 
 Bkz. Durum Tablosu
İstek örneği:
{
  "action": "FINISH_ACTIVATION",
  "key": "qwerty123",
  "smsId": 100,
  "status": 3
}
Yanıt örneği:
{
  "status": "SUCCESS"
}
🆕 5. PUSH_CALL_RECORD İstek Yöntemi

Bu POST isteği, ortağın sunucusundan Grizzly SMS sunucusuna şu adrese gönderilir:  https://api.grizzlysms.com/agent/api/sms

"SUCCESS" durumlu bir yanıt alırsanız, SMS'i veritabanınızda başarıyla teslim edildi olarak işaretleyin ve tekrar göndermeyin. "SUCCESS" dışındaki bir durum döndürülürse, "SUCCESS" durumu alana kadar isteği 10 saniye gecikmeyle tekrarlayın.

Content-Type: multipart/form-data
İstek Alanları
Alan Tür Gerekli Açıklama
action String
 
 PUSH_CALL_RECORD
key String
 
 Protokol anahtarı
callId Ulong
 
 Ortağın sistemindeki çağrı ID'si
phone Ulong
 
 Telefon numarası (ülke kodu dahil) 
phoneFrom String
 
 Arayanın telefon numarası
text String 'file' boşsa gerekli kayıt metni
file Binary 'text' boşsa gerekli dosya wav, amr, mp3, ogg
Yanıt
Alan Tür Gerekli Açıklama

status

 String
 
 (bkz. Durum Tablosu)
İstek örneği:
{
  "action": "PUSH_CALL_RECORD",
  "key": "qwerty123",
  "recordID": 1
  "phone": 447472190082
  "phoneFrom": "443355667788",
  "text": "Microsoft access code: 5015"
}
Yanıt örneği:
{
  "status": "SUCCESS"
}
🆕 6. PUSH_CALL İstek Yöntemi

Bu POST isteği, ortağın sunucusundan Grizzly SMS sunucusuna şu adrese gönderilir:  https://api.grizzlysms.com/agent/api/sms

"SUCCESS" durumlu bir yanıt alırsanız, SMS'i veritabanınızda başarıyla teslim edildi olarak işaretleyin ve tekrar göndermeyin. "SUCCESS" dışındaki bir durum döndürülürse, "SUCCESS" durumu alana kadar isteği 10 saniye gecikmeyle tekrarlayın.

İstek Alanları
Alan Tür Gerekli Açıklama
action String
 
 PUSH_CALL
key String
 
 Protokol anahtarı
callId Ulong
 
 Ortağın sistemindeki çağrı ID'si
phone Ulong
 
 Telefon numarası (ülke kodu dahil)
phoneFrom String
 
 Arayanın telefon numarası
Yanıt
Alan Tür Gerekli Açıklama

status

 String
 
 (bkz. Durum Tablosu)
İstek örneği:
{
  "action": "PUSH_CALL",
  "key": "qwerty123",
  "callID": 1
  "phone": 447472190082,
  "phoneFrom": "447472190099"
}
Yanıt örneği:
{
  "status": "SUCCESS"
}
Durum Tablosu
İstek Alanlarının Yapısı
Durum Açıklama
SUCCESS İstek başarıyla tamamlandı
ERROR İstek yürütme sırasında hata oluştu. ERROR alanı bir açıklama ile doldurulmalıdır
NO_NUMBERS Kullanılabilir numara yok. Bu yanıt yalnızca numara isteği için döndürülür
Aktivasyon Durumu
Durum Açıklama

1

 Bu hizmet için numara verilmesi yasaktır
3 Aktivasyon başarıyla satıldı. Ödül aldınız
4 Aktivasyon iptal edildi*
5 Aktivasyon iade edildi. Müşteri aktivasyon için geri ödeme aldı. Bu numaranın daha önce kaydedilmiş olması ve numarada iki faktörlü kimlik doğrulamanın etkinleştirilmiş olması mümkündür

**İptal mekanizması şu şekilde çalışır: Bir telefon numarası 5 kez iptal edildiyse, aynı numarayı tekrar vermemelisiniz. Numaranın müşteri için uygun olmaması veya belirli bir hizmet için zaten kaydedilmiş olması mümkündür.

İsteğe başarılı yanıt:
{
  "status": "SUCCESS",
  //information
}
Hata durumunda yanıt:
{
  "status": "ERROR",
 "error": "Description of the error"
}
Protokolün Test Edilmesi

Eşzamanlı Numara Verme. Eşzamanlı istekleri düzgün şekilde yönetmeli ve numaraları tekrar tekrar vermemelisiniz. Örneğin, Telegram Endonezya için 100 numaranız varsa ve Grizzly SMS eşzamanlı olarak Telegram Birleşik Krallık için 100 istek yaparsa, ortak sunucu 100 benzersiz numara sağlamalıdır. Bir numara birden fazla kez verilirse, test başarısız olur.

Doğru Aktivasyon Tamamlama. Aktivasyon durumu değişikliği tamamen Grizzly SMS tarafından kontrol edilir. Ortak sunucu, aktivasyonları özerk şekilde tamamlamamalıdır.

SMS Teslimat Doğrulama. Bir SMS aldıktan sonra, derhal Grizzly SMS sunucusuna iletmeniz gerekmektedir. SUCCESS durumu alırsanız, SMS'i tekrar iletmemelisiniz. Ancak farklı bir durum alırsanız, isteği her 10-20 saniyede bir tekrar denemelisiniz. SUCCESS durumu alındıktan sonra bir SMS tekrar iletilirse, test başarısız olur.

Alan Türü Doğrulama. Bu dokümantasyonda belirtilen alan türlerini dikkatlice kontrol edin. Bu koşul ihlal edilirse, test başarısız olur.

 

Telefon Numarasında Ülke Kodu. Telefon numarası verme işlemi dijital formatta olmalı ve ülke kodunu içermelidir.

Numara Verme Süresi Doğrulama. Numaraları 3 saniyeden kısa bir gecikmeyle vermeniz gerekmektedir. 3 saniyeden fazla sürerse, test başarısız olur.

Numara Adedi Doğrulama. Numara adedi isteğinde 1000 numara vermeniz gerekirken, aynı anda yalnızca 100 numara verilirse, test başarısız olur.

İstisna İşleme Doğrulama. Numara verme ile ilgili istisnaları yanlış şekilde işlerseniz, test başarısız olur.

Veri Tablosu
Veri Tablosu:
Listeler Bağlantılar
Ülke listesi İsimleri ve ID'leri ile birlikte tam ülke listesine bu bağlantıdan ulaşabilirsiniz
Operatör listesi Şu anda operatörlere göre ayrım geliştirme aşamasındadır, bu nedenle 'any' değerini geçmelisiniz. Bu işlevsellik uygulandığında, teknik destek sohbeti üzerinden sizi bilgilendireceğiz.
Hizmet listesi İsimleri ve ID'leri ile birlikte tam hizmet listesine bu bağlantıdan ulaşabilirsiniz
Fiyat Değişikliği için API

Bu API, tarafınızda slider'ların (hizmet fiyatları) çalışmasının otomasyonuna yöneliktir.

API'ye şu adresten ulaşılabilir: https://agent.1grizzlysms.com .
İsteklerde kimlik doğrulama için HTTP başlığında apikey ile API anahtarınızı göndermeniz gerekmektedir.

Tüm veriler JSON formatında iletilir.
GET istekleri için Accept: application/json HTTP başlığı, POST istekleri için ise Accept: application/json ve Content-Type: application/json başlıkları gönderilmelidir.

country parametresinin mevcut değerleri, Ülke listesi içindeki ID sütununda bulunmaktadır.
Service parametresinin mevcut değerleri ise Hizmet listesi içindeki ID sütununda yer almaktadır.

Hükümler ve Cezalar

Para Çekme. Kazanılan fonların çekilmesi istekler aracılığıyla gerçekleştirilir. Ortak, Para Çekme bölümünde bir istek oluşturabilir. 100 USDT'den başlayan kazançlar tek işlemde çekilebilir. İstekler günlük olarak 08:00-20:00 (UTC) saatleri arasında 20-180 dakika içinde işleme alınır. Size herhangi bir bonus vaat edildiyse (web sitesinde yayınlanan hüküm ve koşullara göre), lütfen bunu isteğin yorumlar bölümünde belirttiğinizden emin olun.

2FA ve Yanlış Kod Tazminatları. Grizzly SMS platformu, aracı olarak, 2FA ve yanlış kodlu Telegram numaraları için müşterileri tam olarak tazmin eder. Grizzly SMS, 2FA bilgilerini Telegram Expert ve TG-GIANT yazılımlarından otomatik olarak alır. Önemli: 2FA ve yanlış kodlu ("wrong code" yanıtı) numaralar ve Telegram hesapları için fonlar kesintiye tabi değildir. 2FA veya wrong_code hakkında bilgileri Aktivasyon Geçmişi bölümünde görebilirsiniz.

OpenAPI

OpenAPI Dokümantasyonu. OpenAPI (YAML) formatında kapsamlı API dokümantasyonu sağlıyoruz. Tüm mevcut yöntemleri, parametreleri ve örnekleri etkileşimli dokümantasyonumuzda keşfedebilirsiniz. Dokümantasyon; istek formatları, yanıt yapıları, hata kodları ve kimlik doğrulama yöntemleri hakkında detaylı bilgiler içerir.

Speksifikasyona Erişim. OpenAPI spesifikasyonu https://api.grizzlysms.com/docs/agent adresinde mevcuttur. Bu spesifikasyonu, OpenAPI standardını destekleyen çeşitli araçlarla API'mizle entegrasyon yapmak, istemci kütüphaneleri oluşturmak veya doğrudan dokümantasyondan endpoint'leri test etmek için kullanabilirsiniz.