Satış Ortağı API'si korumalı alanı
Test çağrıları yapmak için SP-API sanal alanını kullanın.
Satış Ortağı API'si, uygulamalarınızı üretim verilerini etkilemeden ve gerçek hayatta hiçbir şeyi tetiklemeden test edebileceğiniz iki korumalı alan ortamı sağlar. Satış Ortağı API'sinin statik korumalı alanı, statik ve sahte yanıtlar döndürmek için model eşleştirmeyi kullanır. Satış Ortağı API'si dinamik korumalı alanı ile istekler, istek parametrelerine göre gerçekçi yanıtlar döndürebilen bir korumalı alan arka ucuna yönlendirilir.
Önemli
The sandbox environments are for testing functionality, not scalability testing. Calls to sandbox endpoints are subject to these throttling limits: rate = five requests per second; burst = 15. For more information about throttling refer to Usage Plans and Rate Limits in the Selling Partner API.
If you are using an SP-API sandbox environment to test a call that requires a Restricted Data Token (RDT), you must get the RDT from the production environment and pass it to your sandbox call. More information about restricted operations for which you will need an RDT can be found here.
İçindekiler
Satış Ortağı API'si statik korumalı alanı
Making sandbox calls to the Selling Partner API static sandbox (static sandbox) is identical to making production calls except you direct the calls to the Selling Partner API sandbox endpoints. Calling the sandbox endpoints returns static, mocked responses for all Selling Partner APIs. You can refer to these mocked responses in the Swagger model JSON file for the API that you want to call. For more information, refer to How to make a static sandbox call to the Selling Partner API.
Satış Ortağı API'si korumalı alanı birçok sahte öğe oluşturma çerçevesi gibi çalışır. Belirtilen parametreler mevcut olduğunda belirtilen yanıtı döndürmek için model eşleştirmeyi kullanır. Geliştirici, belirtilen parametreleri içeren bir istek gönderdiğinde aşağıdaki nesnelerin birinde tanımlanan bir yanıt alır:
Statik korumalı alan JSON nesneleri
"x-amzn-api-sandbox":
{
"static": [
{
"request":
{
"parameters":
{
…
}
},
"response":
{
…
}
}
]
}
Bu nesnelerde, sahte bir yanıtla eşleşmesi için gereken parametreler bulunsa da başarılı bir yanıt için gereken tüm parametrelerin yer almadığını hatırlatırız. Başarılı bir yanıt almak için isteğinizin geçerli olduğundan ve ilgili Swagger modelinde tanımlanan gerekli tüm parametreleri içerdiğinden emin olun.
Satış Ortağı API'sine statik korumalı alan çağrısı yapma
1. Adım: İstek parametreleri için JSON dosyasını kontrol edin
-
Go to the Documentation page.
-
Soldaki gezinme bölmesinde, korumalı alan çağrısı yapmak istediğiniz API'nin klasörünü bulun.
-
İstediğiniz API için Swagger modeli JSON dosyasını seçin.
JSON kodu gösterilir.
-
Kodda,
"static"
dizisi içerenx-amzn-api-sandbox
nesnesini arayın.
The static sandbox JSON objects will contain request and response examples for static sandbox calls to the API operation in which they appear. If the request example contains parameters, use them in the following step.
2. Adım: Bir API'ye statik korumalı alan çağrısı yapın
Bir API'ye statik korumalı alan çağrısını, üretim çağrısındaki gibi yapın. Aralarındaki farklar şu şekildedir:
-
Include the parameters from Step 1. Check the JSON file for request parameters in your call. If the API requires parameters in addition to those, be sure to also include those required parameters in your call.
-
Direct your call to one of the Selling Partner API sandbox endpoints.
1. adımdaki statik korumalı alan JSON nesnesinde yer alan yük nesnesiyle eşleşen bir yanıt almanız gerekir.
Satış Ortağı API'si dinamik korumalı alanı
Making calls to the Selling Partner API dynamic sandbox (dynamic sandbox) is identical to making production calls except you direct the calls to the Selling Partner API sandbox endpoints. Dynamic sandbox calls are proxied (that is, forwarded) to a sandbox backend, which returns an appropriate response given the request parameters. Because you are not limited to exact pattern matching, you can make requests and receive responses that are potentially stateful and react to input. For example, you might want to verify the shipping charges for different ship-to addresses. What you can do is limited only by the capabilities supported by the sandbox backend provided for that API section.
Ç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üzeyinde bulunduğu takdirde bu yol içindeki tüm işlemler, dinamik korumalı alana çağrı yapabilir.
Satış Ortağı API'sine dinamik korumalı alan çağrısı yapma
1. Adım: Dinamik korumalı alan çağrılarını destekleyen işlemler için JSON dosyasını kontrol edin
-
Go to the Documentation page.
-
Soldaki gezinme bölmesinde, korumalı alan çağrısı yapmak istediğiniz API'nin klasörünü bulun.
-
İstediğiniz API için Swagger modeli JSON dosyasını seçin.
JSON kodu gösterilir.
-
Kodda şunu arayın:
"x-amzn-api-sandbox":
{
"dynamic": {}
}
İşlem, bu nesneyi yol veya işlem düzeyinde içeriyorsa dinamik korumalı alan desteklenir.
2. Adım: Bir API'ye dinamik korumalı alan çağrısı yapın
Make a dynamic sandbox call to an API in the same way you would make a production call, except direct your call to one of the Selling Partner API sandbox endpoints.
Sadece korumalı alana özel işlemler
The sandbox environments support optional APIs that are sandbox-only and can succeed only when directed to one of the Selling Partner API sandbox endpoints. You can determine which operations are sandbox-only by reviewing the Swagger model JSON for the API section. An operation that is sandbox-only contains "x-amzn-api-sandbox-only": true
at either the operation or path level. When at the path level, all operations within the path are sandbox-only.
Sadece korumalı alana özel işlemler, üretim API'sini destekleyerek üretim API işlemlerini kullandığınızda mümkün olmayan test iş akışları oluşturmanızı sağlar. Örneğin, bir veri öğesinin API aracılığıyla değil, kullanıcı arayüzüyle başlatıldığı bir kullanım senaryonuz olabilir. Yalnızca test amacıyla, daha eksiksiz test iş akışları sunacak veri öğesini oluşturan, sadece korumalı alana özel API sağlanabilir.
Satış Ortağı API'si korumalı alan uç noktaları
Satış Ortağı API'sinin; Kuzey Amerika, Avrupa ve Uzak Doğu satış bölgeleri için korumalı alan uç noktaları vardır.
Satış bölgesi | Uç nokta | AWS Bölgesi |
---|---|---|
Kuzey Amerika (Kanada, ABD, Meksika ve Brezilya pazaryerleri) | https://sandbox.sellingpartnerapi-na.amazon.com | us-east-1 |
Avrupa (İspanya, İngiltere, Fransa, Hollanda, Almanya, İtalya, İsveç, Polonya, Mısır, Türkiye, Birleşik Arap Emirlikleri ve Hindistan pazaryerleri) | https://sandbox.sellingpartnerapi-eu.amazon.com | eu-west-1 |
Uzak Doğu (Singapur, Avustralya ve Japonya pazaryerleri) | https://sandbox.sellingpartnerapi-fe.amazon.com | us-west-2 |
Updated 23 days ago