Wish API iş ortağı entegratörlerinin Wish API belgelerini, Satıcı Kontrol Paneline kıyasla API aracılığıyla ne gibi işlemler yapılacağını ve Wish ile entegrasyon oluşturulurken hangi özelliklerin desteklenmesinin kritik önem taşıdığını daha iyi anlamalarına yardımcı olmak için, API iş ortaklarına API aracılığıyla herkese genel bir yaratmaya nasıl başlayacaklarını anlatan aşağıdaki kılavuzu hazırladık. Lütfen aşağıdaki adımları uygulayın:
1. Wish sandbox ortamında genel uygulama için kaydolun:
1). İş ortağı, Wish sandbox ortamında ERP Kayıt sayfası aracılığıyla ERP olarak kaydolur. İş Ortağı, Wish API belgelerini inceleyebilir.
2). İş Ortağı, Wish İş Ortağı API e-posta adresine (partner-api@wish.com), Wish sandbox ortamına İş Ortağı API erişimi için kaydolduğunu Wish'e bildirmek amacıyla e-posta gönderir.
3). Wish, İş Ortağının başvurusunu onaylayacaktır.
4). İş Ortağı, onaylandıktan sonra oturum açmalıdır.
5). Hesap > Uygulama Oluştur üzerine tıklayın.
Bir uygulama Adı oluşturun (satıcıların görmesini istediğiniz bir ad kullanın). OAuth için yönlendirme URL'si gereklidir (yetkilendirmenin gönderildiği yerdir, istediğiniz zaman değiştirebilirsiniz).
Sandbox'ta yukarıdaki sayfada yer alan detayların satıcılar tarafından görülmeyeceğini lütfen unutmayın.
6). İş ortağına, İş Ortağı tarafından Wish sandbox'ta satıcı hesabı testi yapmak için kullanılacak bir istemci kimliği ve istemci gizli anahtarı sağlanacaktır ( Wish API OAuth işlemi için sandbox'ta istemci kimliği ve istemci gizli anahtarı gerekir).
2. İş Ortağı, Sandbox'ta satıcı olarak ikinci bir oturum açmalıdır. Bu, korumalı sandbox ortamı olduğu için İş Ortağının girdiği satıcı bilgilerinin gerçek bir satıcıya ait olması gerekmez.
1). İş Ortağı Wish'e giriş yapmak için ERP'ye kaydolurken kullandığından farklı bir e-posta kullanacak ve satıcı olarak genel uygulama geliştirmeye başlayacaktır.
2). Sahte satıcı hesabını ERP İş Ortağı ile ilişkilendirin.
a). Satıcı sandbox'da satıcı olarak oturum açtığında URL'yi https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} olarak değiştirmelidir; burada {client_id}, ERP'nin genel uygulamayı oluştururken ürettiği client_id'dir. Bu işlem satıcının ERP'yi satıcı mağazasına tam erişime sahip olması için yetkilendirmesini isteyen bir uyarıyı tetikleyecektir.
b.) Satıcı izin verdiğinde URL https://example.redirect.uri.com?code={authorization_code} olarak değişir, burada ERP Genel Uygulamayı oluştururken yeniden yönlendirme belirtilir.
c). Bu noktada tipik oAuth süreçleri takip edilebilir
d). Tüm API istekleri access_token içermelidir. Erişim belirteçleri 30 gün boyunca geçerlidir.
e). Yeni erişim belirteçleri almak için refresh_token kullanılabilir. Bu eylem önceki belirteci geçersiz kılar.
3). İş ortağı, tüm testleri Wish sandbox ortamında yapacaktır.
4). İlerlemek için Wish'ten ek onay gerekmez
3. Wish üretim ortamında genel uygulama için kaydolun
1). İş ortağı, Wish üretim ortamındaki ERP Kayıt sayfası aracılığıyla üretimde ERP olarak kaydolur.
2). İş Ortağı, Wish İş Ortağı API e-posta adresine (partner-api@wish.com), Wish üretim ortamına İş Ortağı API erişimi için kaydolduğunu Wish'e bildirmek amacıyla e-posta gönderir.
3). Wish, İş Ortağının başvurusunu onaylar veya İş Ortağına belirlenen sorunları bildirir.
4). Onaylandıktan sonra giriş yapabilir ve Hesap > Uygulama Oluştur'u seçebilirsiniz.
İş ortağı, Wish App Store'da yayınlanacak bilgileri girer. Uygulama adı ve Yönlendirme URL'si zorunlu alanlardır. İş ortağı ayrıca uygulama logosu, değer teklifi, açıklama, web sitesi ve/veya destek e-postası gibi ek bilgiler de girebilir. Bu bilgiler satıcılar tarafından görüleceği için inceleme sürecinden geçmesi gerekir.
Bu ek bilgi girilirse, uygulama yine de oluşturulacak ve API ile entegre edilebilecek, ancak bu alanlar yalnızca onaylandıktan sonra Wish App Store'da yayınlanacaktır. Bu arada, bu ek bilgi alanlarının onay durumu aşağıda gösterildiği gibi görüntülenebilir.
Hesap > Uygulama Ayarları'na giderek yukarıda gönderilen tüm bilgileri (gerekli veya ek) görüntüleyebilir ve düzenleyebilirsiniz . Ek bilgi alanlarındaki ayrıntılar düzenlenirse veya silinirse inceleme sürecinden tekrar geçmeleri gerekir.
5). Wish Üretim ortamı API belgelerini gözden geçirin
6). İş ortağı OAuth sürecini tamamlar.
7). İş ortaklarının Wish üretim ortamındaki entegrasyonlarını açmaları ve API çağrılarını sandbox ortamı yerine Wish üretim ortamına yönlendirmeyi unutmamaları gerekir.
4. Satıcılar Wish Satıcı Kontrol Panelinde benzersiz bir mağaza hesabı kaydetmeli ve ERP'yi satıcının Wish mağazasına/mağazasından veri göndermesi/alması için yetkilendirmelidir.
1). Satıcıların satıcı hesap kaydının bir parçası olarak Wish tarafından onaylanacak işletme lisansını ve kişisel bilgi kimliğini doğrulayan bilgileri göndermeleri gerekir.
2). Satıcı hesapları bir Wish hesap yöneticisi temsilcisi tarafından onaylanacaktır.
3). Satıcılar daha sonra aşağıdaki yöntemlerden biriyle ERP'ye yetki vermelidir:
a). Satıcı kendi seçtiği ERP'de bir hesap kaydı yaptırır.
(i) Satıcı, ERP'yi yetkilendirebileceği bir OAuth Yetkilendirme sayfasına yönlendirmek için ERP arayüzünden Wish yetkilendirme bağlantısını seçer.
• Bağlantı, ERP'nin benzersiz üretim müşteri kimliği ile aşağıdaki gibi olmalıdır: https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}
(ii) Satıcı, kendisini bir yetkilendirme koduyla ERP'nin belirlediği "Yönlendirme URI'sine" yönlendirmek için "Yetkilendir"i tıklar. ERP, erişim belirteci almak amacıyla Wish API'lerini çağırmak için bu yetkilendirme kodunu kullanır.
b). Satıcı, Wish App Store'da ERP'yi bulur (NOT: Bu süreç henüz başlatılmadı, ancak ERP'ler gelecekteki lansmanına hazırlık olarak bu süreci ele alabilmelidir):
(i) Satıcı, kendisini ERP'yi yetkilendirebileceği bir OAuth Yetkilendirme sayfasına yönlendirmek için "Uygulama Ekle"yi seçer.
(ii) Satıcı, kendisini bir yetkilendirme koduyla ERP'nin belirlediği "Yönlendirme URI'sine" yönlendirmek için "Yetkilendir"i tıklar. ERP, erişim belirteci almak amacıyla Wish API'lerini çağırmak için bu yetkilendirme kodunu kullanır.
• ERP tarafından belirtilen "URI'yi Yönlendir" sayfası, satıcının oturum açmadığı ve/veya ERP'de bir hesabı olmadığı durumu işleyemiyorsa bağlantı tamamlanmayabilir.
• Bağlantıyı tamamlamak için satıcıdan ERP'nizde oturum açmasını veya kaydolmasını isteyin. Ardından, yetkilendirme kodunu url'de ileriye taşıyın ve satıcı oturum açtıktan veya hesap oluşturduktan sonra OAuth işlemini tamamlayın.
c). Yetkilendirme artık tamamlanmıştır.
d). Satıcı herhangi bir noktada ERP'nin yetkisini kaldırmayı planlıyorsa, satıcı bunu Wish Satıcı Kontrol Panelinde Hesap > Ayarlar > API Ayarları altından yapabilir.
Ortak uygulamaların güvenliğini artırmak için iş ortaklarının artık herkese açık uygulamaları için 2 adede kadar OAuth istemci gizli anahtarı ekleyebileceklerini lütfen unutmayın. Uygulama Ayarları sayfanıza gidin ve ikinci bir istemci gizli anahtarı eklemek için ilk istemci gizli anahtarının altındaki "İkinci anahtar ekle" bağlantısına tıklayın.
İş ortakları gerekirse istemci gizli anahtarının ele geçirilmesi durumunda birini silerek ve yeni bir tane ekleyerek 2 istemci gizli anahtarını da döndürebilir.
Not: Belgelere, ipuçlarına, öğreticilere ve daha fazlasına bağlantılar için Wish Geliştirici Sayfasına göz atın.
Yorumlar
0 yorum
Yorum yazmak için lütfen oturum açın: oturum aç.