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

İstekler API'si v1 Kullanım Senaryosu Rehberi

Alıcılara tutarlı ve yüksek kaliteli istekler gönderin.

API Sürümü: v1

İstekler API'si nedir?

Kullanabilirsiniz İstekler için Satış Ortağı API'si (Talep API'si) satıcıların alıcılara tutarlı, yüksek kaliteli talepler göndermesine olanak tanıyan uygulamalar oluşturmak. Satıcılar, tek bir şablon tabanlı e-posta göndererek hem ürün incelemesi hem de satıcı geri bildirimi talep edebilir.

Eğitim 1: Talep API'sini ayarlama

Bu kılavuz, geri bildirim istemeden önce Talep API"sinin nasıl kurulacağını gösterir..

Ön koşullar

Bu eğitimi tamamlamak için şunlara ihtiyacınız var:

The Solicitations API implementation flowchart

Adım 1. Abone ol ORDER_CHANGE bildirim

Daha fazla bilgi için bkz. Eğitim: ORDER_CHANGE Bildirimine abone olun.

Adım 2. Doğrula OrderStatus parametre

Amazon Basit Kuyruk Hizmeti (SQS) iş akışları aşağıdaki yükü alır. ORDER_CHANGE bildirim. Doğrulamak için Amazon SQS'yi kullanabilirsiniz. OrderStatus parametre. Kontrol edin OrderStatus Değer şu şekilde değişti Shipped. Belirli bir sipariş için bir talebin gönderilip gönderilmediğinden emin olmak için işten çıkarılmaları ortadan kaldırın. SQS kuyruğunun nasıl anketileceği hakkında daha fazla bilgi için bkz. Eğitim: Bildirimleri ayarlama (Amazon Basit Kuyruk Hizmeti iş akışı).

Adım 3. Kontrol edin EarliestDeliveryDate ve LatestDeliveryDate parametreler

Talep talebinde bulunabilirsiniz, tarihten sonraki beş günlük bir zaman dilimi içinde talep edebilirsiniz. EarliestDeliveryDate 30 gün sonrasına kadar LatestDeliveryDate. Talep API'sinin bu zaman dilimi dışında çağrılması beklenmedik API hatalarına yol açacaktır.

Adım 4. Anahtar tanımlayıcıları saklayın

Arşivleyin veya önbelleğe alın amazonOrderId ve MarketplaceId parametreleri. Bu tanımlayıcılar gelecekte inceleme istemek için gereklidir.

Artık geri bildirim istemeye hazırsınız.

Eğitici içerik: Bir sipariş için geri bildirim isteyin

Bu eğitici içerik, bir sipariş için nasıl ürün yorumu ve satıcı değerlendirmesi isteyebileceğinizi gösterir. Öncelikle bir siparişin isteğe uygun olduğunu doğrulayın ve ardından isteği oluşturun.

Ön koşullar

Bu eğitimi tamamlamak için şunlara ihtiyacınız var:

1. Adım: Bir siparişin isteğe uygun olduğunu doğrulayın

Aşağıdaki parametreleri ileterek getSolicitationActionsForOrder işlemini çağırın:

Yol parametresi

Parametre Açıklama Zorunlu mu?
amazonOrderId

Amazon sipariş tanımlayıcısı. Kullanılabilir istek türlerinin listesini istediğiniz siparişi belirtir.

Tür: dize

Evet

Sorgu parametresi

Parametre Açıklama Zorunlu mu?
marketplaceIds

Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir.

Tür: dizi[Dize]

Evet

İstek örneği

GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777 ?marketplaceIds=ATVPDKIKX0DER

Yanıt örnekleri

İstek işlemleri olmadığında geçerli olan yanıt örneği:

{ "_links": { "actions": [], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [] } }

İstek işlemleri olduğunda geçerli olan yanıt örneği:

{ "_links": { "actions": [ { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } ], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [ { "_links": { "schema": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" }, "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } }, "_embedded": { "schema": { "_links": { "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" } }, "type": "object", "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review", "description": "Request seller feedback and product review", "properties": {}, "required": [], "$schema": "http://json-schema.org/draft-04/schema#", "x-ui-hidden": true } }, "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review" } ] } }

2. Adım: Ürün yorumu isteği oluşturun

Yanıtta productReviewAndSellerFeedback işlemi varsa aşağıdaki parametreleri ileterek createProductReviewAndSellerFeedbackSolicitation işlemini çağırın:

Yol parametresi

Parametre Açıklama Zorunlu mu?
amazonOrderId

Amazon sipariş tanımlayıcısı. İsteğin gönderildiği siparişi belirtir.

Tür: dize

Evet

Sorgu parametresi

Parametre Açıklama Zorunlu mu?
marketplaceIds

Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir.

Tür: dizi[Dize]

Evet

İstek örneği

POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback ?marketplaceIds=ATVPDKIKX0DER

Yanıt örnekleri

Uygun olmayan bir sipariş için yanıt örneği:

{}

Uygun olmayan bir sipariş için yanıt örneği:

{ "errors": [ { "code": "Unauthorized", "message": "The requested solicitation is not available for this amazonOrderId.", "details": "" } ] }

En iyi uygulamalar

İnceleme talep ettiğinizde, şunları yaptığınızdan emin olun:

  • Teslim edilen siparişler için inceleme isteyin.
  • İzin verilen zaman dilimi içinde geri bildirim isteyin.

Yapamayacağınızı unutmayın:

  • Seçici olarak olumlu eleştiriler arayın.
  • Mevcut incelemelerde değişiklik talep edin.
  • İncelemeler için ödüller veya teşvikler sunun.

Taleplerde etik olarak nasıl gezinileceği hakkında daha fazla bilgi için, bkz. Müşteri İncelemeleri için Manipülasyon Önleme Politikası.

Olumsuz geri bildirimleri fırsatlara dönüştürün

Olumsuz yorumlar aldığınızda, alıcının sorununu çözme çabanız anlatıyı değiştirebilir. Alıcının sorununu çözdükten sonra, arayın createNegativeFeedbackRemoval işlem tarafından Mesajlaşma API'si. Satıcılar, alıcıdan olumsuz geri bildirimi kaldırmasını istemek için bu işlemi kullanabilir. Bu, satıcılara ikinci bir şans sunar ve müşteri memnuniyetine olan bağlılıklarının altını çiziyor.


Bu sayfa size yardımcı oldu mu?