Web SDK

Gereklilikler

İşlemlere başlamadan önce kullanılacak login page url’inin cname olarak lcname.zotlo.com adresine yönlendirilmesi gerekmektedir
Zotlo Web SDK ile kullanıcıların login işlemini gerçekleştirebilmek için aşağıdaki örnekte olduğu gibi ilgili javascript dosyasının login ekranına eklenmesi gerekmektedir.
<script type="text/javascript" src=https://cdn.zotlo.com/tr/sdk.js?publicKey=(publicKey gelecektir)"></script>

Javascript dosyasını ekledikten sonra sayfanıza ekleyeceğiniz login butonunu aşağıdaki yöntemlerle oluşturabilirsiniz.

1.Login butonunu manuel olarak oluşturmak isterseniz html sayfanıza ekleyeceğiniz a veya buton elementinin onclick event’ine aşağıdaki örnekte olduğu gibi ”Zotlo. login()” eklemelisiniz.
<button type=button" onclick=Zotlo.login();">SMS ile Giriş Yap</button>
2.Login butonunu otomatik olarak oluşturmak isterseniz html sayfanıza aşağıdaki div elementini eklemeniz gerekmektedir.
<div class="zotlo-login-buttons"></div>

Yukarıdaki adımlardan bir tanesi ile login butonunuzu oluşturduktan sonra aşağıdaki javascript kodunun sayfanıza eklenmesi gerekmektedir.

1
<script>
2
Zotlo.init({
3
publicKey: '',
4
redirectUri:'',
5
loginButton: true
6
});
7
</script>
Copied!
#
Açıklama
PublicKey
Bu alana uygulamanıza ait API public key gelecektir.
RedirectUri
Bu alana uygulamanızda tanımladığınız geri dönüş adresiniz gelecektir.
loginButton
“true” olarak tanımlanırsa login butonu otomatik olarak oluşacaktır. * zotlo-login-button şeklinde bir div elementinin sayfaya eklenmiş olması gerekmektedir
Kullanıcılar “SMS ile Giriş Yap” butonuna tıkladıklarında pop-up içerisinde doğrulama ekranları açılır ve doğrulama işlemleri tamamlandığında “Zotlo.init” içerisine tanımlanan redirectUri adresine abonelik bilgilerini alabilmek için bir token değeri GET metodu ile gönderilir.

RedirectUri adresinize gelen token değeri ile uygulamanıza ait Access Key ve Access Secret bilgilerini purchaseList API endpoint’ine istek atarak kullanıcının faydasının olup olmadığı kontrol edilebilir.

Access Key ve Access Secret bilgileri Teknasyon onboarding ekibi tarafından iletilecektir.

Development

Uygulama içerisinde callback servisleri tanımlanmış ise düzenli olarak kullanıcıların fayda durumu takip edilebilir ve güncellemeler alınabilir.
Callback servisleri tanımlanmamış ise kullanıcıların fayda durumu her loginde uygulama tarafına iletilecektir. Login durumunda olan ve faydaları bitmiş olan kullanıcıların session yönetimi uygulama tarafında yapılmalıdır.

Örnek Request

1
curl --location --request GET 'https://api.zotlo.com/v1/purchase/list?token=***' \
2
--header 'AccessKey: ***' \
3
--header 'AccessSecret: ***' \
4
--header 'ApplicationId: **' \
5
--header 'Language: tr'
Copied!

Başarılı Sonuç

1
"meta": {
2
"requestId": "7198eab26992-REQ-60c0e6f255d65",
3
"httpStatus": 200
4
},
5
"result": [
6
{
7
"status": "active",
8
"realStatus": "active",
9
"subscriberId": "***",
10
"subscriptionType": "trial",
11
"startDate": "2021-05-27 14:44:46",
12
"expireDate": "2021-06-03 14:44:46",
13
"package": "aff.test",
14
"language": "tr",
15
"country": "TR",
16
"phoneNumber": null,
17
"originalTransactionId": "82d75b63-ee6a-41dd-a195- 2d3adbd8459f",
18
"cancellation": null,
19
"quantity": 1,
20
"pendingQuantity": 0,
21
"customParameters": []
22
}
23
]
24
}
Copied!

Başarısız Sonuç

1
{
2
"meta": {
3
"requestId": "app2.localdomain-REQ-5e7db66e67542",
4
"httpStatus": 400,
5
"errorMessage": "Kullanc abonelik profili bulunamadı.",
6
"errorCode": 400009
7
},
8
"result": []
9
}
Copied!
Last modified 2mo ago