Üye İşlemleri
Üye Kayıt ve Giriş İşlemleri
E-ticaret platformuna üye olan kullanıcıların session kontrolü Shop API Customer servisinde yapılmaktadır. Bu servis aracılığı ile üye kayıt, oturum açma ve şifre sıfırlama gibi işlemleri gerçekleştirebilirsiniz.
Bu servisten alınan token bilgisini, üye doğrulaması gerektiren sayfalarda Header içerisinde Bearer Token olarak göndermeniz gerekmektedir.
Yeni Üye Kaydı
Yeni üye kaydı oluşturduktan sonra ayrıca login servisine istek atmanıza gerek yoktur. Servisten dönen token bilgisi ile daha sonra kullanacağınız üye doğrulaması gereken servislerde (Siparişlerim vb.) işlem yapabilirsiniz.
Parametre Tanımlamaları
Aşağıdaki parametreler ile üye servisine istek yapabilirsiniz.
| Değerler | Zorunluluk | Açıklama |
|---|---|---|
| registerType | evet | Eğer ziyaretçi olarak devam edilmek isteniyor ise "guest" olarak bilgi gönderilmelidir. Ön tanımlı değer : "full" |
| fullname | evet | Üye ad soyad bilgisi. Eğer registerType "guest" gönderilirse zorunlu değildir. |
| evet | Üye e-posta bilgisi. | |
| password | evet | Üye şifre bilgisi. Eğer registerType "guest" gönderilirse zorunlu değildir. |
| phone | hayır | Üye telefon bilgisi. |
| gender | hayır | Üye cinsiyet bilgisi. |
| countryCode | hayır | Kayıt olunan ülke bilgisi. Ön tanımlı değer : TR |
| allowPrivacyPolicy | hayır | Gizlilik sözleşmesi onay durumu |
| allowAgreement | hayır | Kullanıcı sözleşmesi onayı |
| allowNotification | hayır | SMS & E-posta bildirimleri onay durumu (İletişim izni) |
| lang | hayır | Servisten beklenen dil bilgisidir. Merchant'a tanımlı dil bilgileri ile istek yapılabilir. |
| basketId | hayır | Gönderilmesi zorunlu değildir. Eğer kayıt işleminde gönderilirse, kayıt sırasında verilen basketId değeri kayıt olan üye ile eşleştirilir ve sepet kaydedilir. |
Örnek İstek
axios.post('{baseUrl}/api/shop/customer/register', {
registerType : 'full',
fullname : 'John Doe',
email : 'john@example.com',
password : '12345678',
phone : '5301231122',
countryCode : 'TR',
allowPrivacyPolicy : 1,
allowNotification : 1,
allowAgreement : 1,
lang : 'tr',
basketId : '12345',
})
Servis Cevabı ve Alan Açıklamaları
| Alan adı | Açıklama |
|---|---|
| status | İşlem sonucu (success, error) |
| message | İşlem sonucu açıklaması |
| userId | Kullanıcı ID bilgisi, bu değeri daha sonraki isteklerde kullanmak üzere saklayabilirsiniz. (localstorage vs.) |
| token | Kullanıcı doğrulaması isteyen servislere bu token ile istekte bulunacağız. Bu yüzden bu tokeni saklamamız gerekiyor. (localstorage, cookie vs.) |
{
"status": "success",
"message": "Kayıt işlemi başarılı.",
"userId": 6205,
"token": "13|0jPJHUWeNlxBZo03yExtfkpuEv0mijmn8OPeFOHM"
}
Oturum Açma & Token Alma
Kayıtlı kullanıcı ile oturum açmak için, login servisinden token almanız gerekmektedir. Token almak için kayıtlı üye bilgilerini göndermeniz yeterlidir.
Parametre Tanımlamaları
Aşağıdaki parametreler ile üye servisine istek yapabilirsiniz.
| Değerler | Zorunluluk | Açıklama |
|---|---|---|
| evet | Üye e-posta bilgisi. | |
| password | evet | Üye şifre bilgisi. |
| lang | hayır | Servisten beklenen dil bilgisidir. Merchant'a tanımlı dil bilgileri ile istek yapılabilir. |
| basketId | hayır | Gönderilmesi zorunlu değildir. Eğer gönderilirse, verilen basketId değeri oturum açan üye ile eşleştirilir ve sepet bilgisi kaydedilir. |
Örnek İstek
axios.post('{baseUrl}/api/shop/customer/login', {
email : 'john@example.com',
password : '12345678',
lang : 'tr',
basketId : '12345',
})
Servis Cevabı ve Alan Açıklamaları
| Alan adı | Açıklama |
|---|---|
| status | İşlem sonucu (success, error) |
| message | İşlem sonucu açıklaması |
| userId | Kullanıcı ID bilgisi, bu değeri daha sonraki isteklerde kullanmak üzere saklayabilirsiniz. (localstorage vs.) |
| token | Kullanıcı doğrulaması isteyen servislere bu token ile istekte bulunacağız. Bu yüzden bu tokeni saklamamız gerekiyor. (localstorage, cookie vs.) |
{
"status": "success",
"message": "Oturum açma işlemi başarılı.",
"userId": 7253,
"token": "88|2vNvs3mpaGGRnWynI1aBerLvT6BhgoKo3Jd8nhoK"
}
Token Silme İşlemi
Bu servise istek yaparak, mevcut tokenin geçersiz olmasını sağlayabilirsiniz. Bu servisi üyenin hesabından çıkış yapmak istediği durumlarda kullanabilirsiniz.
Parametre Tanımlamaları
Aşağıdaki parametreler ile üye servisine istek yapabilirsiniz.
| Değerler | Zorunluluk | Açıklama |
|---|---|---|
| token | evet | Daha önce giriş yada kayıt servislerinden alınan token bilgisi |
Örnek İstek
axios.post('{baseUrl}/api/shop/customer/logout', {
token : '88|2vNvs3mpaGGRnWynI1aBerLvT6BhgoKo3Jd8nhoK',
})
Servis Cevabı
İşlem başarılı ise servisten true cevabı dönmektedir.
true