API Reference

Uygulama Yayınlama

Giriş

SP-API servislerine erişilmesi için uygulama kaydı oluşturmanız gereklidir. Uygulamanızı appstore üzerinde yayınlayabilir veya özel uygulama olarak yaratabilirsiniz.

Uygulama Oluşturma

  1. Seller central sayfasına giriş yapın. (https://sellercentral.amazon.com.tr/)
  2. Sol menüden Uygulamalar ve Hizmetler > Uygulama Geliştirme linkine tıklayın.
  3. Yeni uygulama istemcisi ekle'ye tıklayın. Uygulama adını yazın ve API Türünde SP-API olarak seçin.
  4. Desteklenen ticari işletmeleri seçin.
  5. Rollerinizi seçin. 3 adet rolde kişisel verileri içerir. Kişisel veriler kısıtlanmış rol olarak adlandırılır. Kısıtlanmış roller için aşağıdaki bilgilendirmelere göre gerekli rollere karar verin.

    1. 🚧

      Doğrudan Tüketiciye Kargo - Sipariş bilgilerinde, kargolanacak adres bilgilerine erişmek ve kargo barkodlarını almak için bu rolü işaretleyin.

      Doğrudan tüketiciye kargo rol yetkisinin erişeceği verileri detaylı incelemek için tıklayın.

    2. 🚧

      Vergi Faturalandırması - Sipariş bilgilerinde bireysel ve kurumsal fatura bilgilerine erişmek ve FBA siparişlerini çekebilmek için bu rolü işaretleyin.

      Veri faturalandırması rol yetkisinin erişeceği verileri detaylı incelemek için tıklayın.

    3. 🚧

       Vergi Ödemesi - Bu rol Türkiye'de aktif değildir. Yurtdışı pazaryerlerine bağlanıyorsanız bu rolü talep edebilirsiniz.

      Vergi ödemesi rol yetkisinin erişeceği verileri detaylı incelemek için tıklayın.

  6. Uygulamanızı OAuth yöntemiyle giriş yaptırıcaksanız OAuth Oturum Açma URI ve OAuth Yönlendirme URI bölümlerini doldurun.
    1. OAuth Oturum Açma URI : OAuth Oturum Açma URI, uygulamanızın web sitesinin giriş sayfasına yönelik URI'dir.
    2. OAuth Yönlendirme URI : Amazon, yetkilendirme bilgileriyle beraber satış ortağını tarayıcı üzerinden uygulamanıza yönlendirmek için bu URI'yi kullanır.
      1. OAuth URI yetki alma bölümünde appstore ve websitesi yetkilendirmesi bölümlerinde kullanılır.
      2. Bu bölümde test, canlı için birden fazla link ekleyebilirsiniz. (Localhost linkleri desteklenmemektedir.)
  7. Uygulamanızı yarattıktan sonra Yetki Alma bölümüne geçin.

 Uygulama ve Yetki Bilgilerinin Görüntülenmesi

  1. Seller central sayfasına giriş yapın. (https://sellercentral.amazon.com.tr/)
  2. Sol menüden Uygulamalar ve Hizmetler > Uygulama Geliştirme linkine tıklayın.
  3. Uygulama satırınızdaki LWA kimlik bilgileri görüntüle seçeneğine tıklayın.
  4. İstemci tanımlayıcısı ve İstemci sırrı uygulama yetki bilgilerini içerir.
  5. Yetki alma süreçlerinde kullanmak üzere bu bilgileri saklayın.

Uygulama Yetkilerinin Yenilenmesi

  1. Seller central sayfasına giriş yapın. (https://sellercentral.amazon.com.tr/)
  2. Sol menüden Uygulamalar ve Hizmetler > Uygulama Geliştirme linkine tıklayın.
  3. Yenilemeniz gereken istemci uyarı olarak satırda görünür. Uygulama satırınızdaki LWA kimlik bilgileri bölümüne girin ve yenile butonuna tıklayarak yenileyin.

Dikkat Edilmesi Gerekenler

❗️

Uygulamaya ait istemci bilgileri Amazon kurallarına göre belirli dönemlerde yenilemeniz gerekmektedir. Uygulamanız için istemci bilgilerini yenilemeniz gerekirse e-posta ile iletilecektir.

❗️

Özel geliştiricilerde refresh_token süresiz olarak kullanabilirsiniz. Üçüncü parti uygulamalarda refresh_token 1 sene sonra süresi dolar.

Önemli Notlar

📘

Uygulamalara erişim sağlanması için uygulamanın yayınlanmasına gerek bulunmamaktadır.

📘

Özel geliştirici olarak geliştirdiğiniz uygulamaların yayınlanmasına gerek bulunmamaktadır.

📘

 Yayınlama isteği gönderilen uygulamaların değerlendirilmesi ortalama 14 gün sürer. Kişisel verileri talep ettiğiniz özel roller mevcut ise değerlendirme süresi artar.