Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Eğitim: Satış Ortağı API Uç Noktalarını Test Etme

Üretim verilerini etkilemeden test çağrıları yapmak için sanal alanı kullanın.

Satış Ortağı API'si (SP-API) sağlar sanal alan ortamları SP-API uç noktalarını üretim verilerini etkilemeden test edebileceğiniz yer. Sahte yanıtlar döndüren statik istekler yapmak için çağrıları SP-API sanal alan uç noktalarına yönlendirebilirsiniz. Korumalı alanı kullanarak arama yapmak, istek ve yanıt biçimlerini anlamak, uygulama kimlik bilgilerini doğrulamak için gereken adımları uygulayabilir ve üretim verilerini etkilemeden API uç noktalarıyla oynayabilirsiniz.

Eğitim

Aşağıdaki eğitim, gerekli erişim belirteçlerinin nasıl oluşturulacağını ve SP-API sanal alan uç noktalarına nasıl çağrı yapılacağını gösterir.

Ön koşullar

Bu eğitimi tamamlamak için aşağıdaki ön koşullara ihtiyacınız vardır:

Bu işlem sırasında, daha sonra bir erişim belirteci ile değiştirebileceğiniz bir yenileme belirteci alırsınız. SP-API uç noktalarını çağırmak için bir erişim belirteci gereklidir.

Postman ile test yapmak için gereken değişkenler

Postman ile arama yapmak için önce kimlik bilgilerini ayarlamanız gerekir. Çalışma alanınız için aşağıdaki genel değişkenlere ihtiyacınız olacak:

Adım adım iş akışı

Satış Ortağı API uç noktasını test etmek için aşağıdaki adımları kullanabilirsiniz:

Adım 1. Amazon (LWA) erişim belirteci ile Oturum Açma Oluşturun

Öncelikle, bir satış ortağı adına satış verilerine erişmek için başvurunuzu yetkilendirmeniz gerekir. Amazon ile Oturum Açma (LWA) erişim belirteci oluşturduğunuzda, süresi dolana kadar birden çok SP-API çağrısı için kullanılabilir.

Ayrıntılı adımlar için bkz. Postman'ı kullanarak bir LWA Erişim Belirteci oluşturun veya Adım 1. Amazon erişim belirteci ile Oturum Açma Talep Edin.

Yanıt bir döndürür LWA erişim belirteci SP-API çağrınızı doğrulamak için kullanabileceğiniz. Kişisel Tanımlanabilir Bilgileri (PII) döndüren tüm işlemlere (kısıtlı işlemler hariç) yapılan çağrılara bir LWA erişim belirteci dahil edilmelidir. Kısıtlanmış işlemleri çağırırken, bir LWA erişim belirteci yerine bir Kısıtlı Erişim Belirteci (RDT) eklersiniz

Aşağıdaki resimde erişim belirtecinin başladığı bir örnek gösterilmektedir Atza|**************************** ve sona erer (LWA erişim belirtecinin geçersiz hale gelmesinden önceki saniye sayısı) 3600 saniye (1 saat).

2034

LWA erişim belirteci isteği ve yanıtı

Adım 2. SP-API sanal alan uç noktasına çağrı yapma

Aşağıdaki adımlar, Orders API Swagger modelini kullanarak SP-API sanal alan uç noktasına çağrı yapma pratiğini kapsar. Bu işlemi API çağrılarını test etmek ve sahte istek ve yanıtları incelemek için kullanabilirsiniz.

  1. İçe aktarın Siparişler API'si Postman çalışma alanınıza Swagger modeli.
  2. Bir kod için arama yapın x-amzn-api-sandbox göründükleri API işlemine yönelik statik sanal alan çağrıları için statik bir istek ve yanıt örnekleri dizisi içeren nesne.
  3. İstek parametrelerini, Orders API Swagger modelinin tanımladığı değerlerle ayarlayın.
  4. İsteğinizin ilgili Swagger modelinde tanımlandığı gibi gerekli tüm parametreleri içerdiğini kontrol edin. Aşağıdaki örnek bir Sipariş API'si v0 Swagger modeli, nerede Get Order API çağrısı başarılı bir yanıtla vurgulanır:
2148

Siparişler API v0 Swagger modeli

  1. Bir yap GET Arayın /orders/v0/orders.
  2. Ayarla baseUrl olarak Satış Ortağı API sanal alanı.
  3. Altında Parametreler sekme, Siparişler API modelinden statik istek değerlerini iletin.
2704

Parametreler sekmesinin altındaki statik istek değerleri

  1. Altında Başlıklar sekme, geç access_token alındı Adım 1 anahtar değer çiftini kullanarak her API çağrısı için x-amz-access-token: Atc|********************. Bu adımı atla kısıtlı işlemler ve bağışsız operasyonlar.
2720

Başlıklar sekmesinin altındaki erişim belirteci

  1. için kısıtlı işlemler, Alınan Kısıtlı Veri Simgesini (RDT) iletin createRestrictedDataToken anahtar değer çiftini kullanan işlemler x-amz-access-token: Atz.sprdt|********************.

🚧

Önemli

Alıcı bilgileri veya teslimat adresi gibi bir müşterinin Kişisel Tanımlanabilir Bilgilerine (PII) erişmek için kısıtlanmış bir operasyonu arıyorsanız, bir mesaj iletin Kısıtlı Veri Simgesi (RDT) bir yerine istek başlıklarında LWA erişim belirteci. Arayabilirsiniz CreateStrictedDataToken içinde operasyon Belirteç API'si bir almak için Kısıtlı Veri Simgesi (RDT) belirttiğiniz bir veya daha fazla kısıtlı kaynak için.

Aşağıdaki örnek yanıt bir RDT ve son kullanma süresini döndürür. RDT belirteci şurada kullanılabilir Get Orders PII verilerini alma işlemi.

2708

Kısıtlı Veri Simgesi yanıt ve son kullanma süresi

{ "restrictedDataToken": "Atz.sprdt|IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR", "expiresIn": 3600 }

  1. Yanıtın, Swagger modeliyle eşleşen bir yük döndürdüğünü doğrulayın.
2698

Erişim belirtecini kullanarak Siparişler v0 API statik yanıtını al

Durumsal istekler yapmak için Satış Ortağı API'si dinamik sanal alanını kullanın

SP-API ayrıca bir dinamik sanal alan isteklerde bulunabileceğiniz ve potansiyel olarak durum bilgisi olan ve girdilere tepki veren çeşitli yanıtlar alabileceğiniz yer.

Çağırmak istediğiniz API için Swagger modeli JSON dosyasını inceleyerek dinamik korumalı alan çağrılarını destekleyen işlemleri belirleyebilirsiniz. Bir işlem aşağıdaki nesneyi içeriyorsa dinamik korumalı alana yapılan çağrıları destekler:

"x-amzn-api-sandbox": { "dynamic": {} }

Nesne, işlem veya yol düzeyinde bulunabilir. Yol düzeyindeyken, yol içindeki tüm işlemler dinamik sanal alana çağrı yapabilir.

Dinamik sanal alana çağrı yapma hakkında daha fazla bilgi için bkz. Satış Ortağı API'sine dinamik sanal alan çağrısı nasıl yapılır.

Sonuç

Bu eğitimde, SP-API sanal alan uç noktalarınızı nasıl test edeceğinizi öğrendiniz. İzlenecek açıklamada, bir LWA Erişim Belirteci oluşturdunuz ve sanal alan uç noktalarına SP-API çağrısı örneklerini araştırdınız.


Bu sayfa size yardımcı oldu mu?