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:
- Postman hesabı ve çalışma alanı. Postman'ın nasıl kullanılacağı hakkında daha fazla bilgi için, bkz. Satış Ortağı API modellerini Postman'ı kullanma.
- Kendi satış ortağı hesabınız varsa, şunları yapabilirsiniz: kendi kendini yetkilendirmek hesap bilgilerinize erişmek için başvurunuz.
- Kendi satış ortağı hesabınız yoksa, bir hesap oluşturmanız gerekir. üçüncü taraf OAuth iş akışı. Bu iş akışıyla, üçüncü taraf satıcılar ve satıcılar uygulamanıza Amazon Satış Ortağı verilerine erişmek için yetki verebilir.
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:
client_id
: Bir LWA erişim belirteci istemek için client_id'e sahip olmanız gerekir. client_id sizden sonra görünür uygulamanızı kaydedin. Bu değeri elde etmek için bkz. Geliştirici bilgilerinizi görüntüleme.client_secret
: Bir LWA erişim belirteci istemek için client_secret'e sahip olmanız gerekir. client_secret sizden sonra görünür uygulamanızı kaydedin. Bu değeri elde etmek için bkz. Geliştirici bilgilerinizi görüntüleme.refresh_token
: LWA yenileme belirteci, satış ortağı başvurunuzu yetkilendirdiğinde bu değeri alın. Kendi Satış Ortağı hesabınız varsa, yenileme jetonunu almak için başvurunuzu kendiniz yetkilendirebilirsiniz. Daha fazla bilgi için bkz. Satış Ortağı API uygulamalarını yetkilendirme.base_url_sandbox
: Her bölge için Satış Ortağı API sanal alan uç noktalarını almak için bkz. SP-API sanal alan uç noktaları.
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).

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.
- İçe aktarın Siparişler API'si Postman çalışma alanınıza Swagger modeli.
- 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. - İstek parametrelerini, Orders API Swagger modelinin tanımladığı değerlerle ayarlayın.
- İ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:

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

Parametreler sekmesinin altındaki statik istek değerleri
- 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çinx-amz-access-token
:Atc|********************
. Bu adımı atla kısıtlı işlemler ve bağışsız operasyonlar.

Başlıklar sekmesinin altındaki erişim belirteci
- için kısıtlı işlemler, Alınan Kısıtlı Veri Simgesini (RDT) iletin
createRestrictedDataToken
anahtar değer çiftini kullanan işlemlerx-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.

Kısıtlı Veri Simgesi yanıt ve son kullanma süresi
{ "restrictedDataToken": "Atz.sprdt|IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR", "expiresIn": 3600 }
- Yanıtın, Swagger modeliyle eşleşen bir yük döndürdüğünü doğrulayın.

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.
Updated 8 months ago