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

Satış Ortağı API'sine bağlanma

SP-API'ye nasıl bağlanılır?

Başvurunuzun Satış Ortağı API'sine bağlanabilmesi için, onu kaydetmeniz ve bir satış ortağı tarafından yetkilendirilmesi gerekir. Bakınız Başvurunuzu kaydetme ve Satış Ortağı API uygulamalarını yetkilendirme.

Bu talimatlar, Satış Ortağı API'sini arama yapma adımlarını gösterir. Satış Ortağı API URI'si oluşturma ve üstbilgi ekleme konusunda yardım için bkz. Java istemci kitaplığı oluşturma. LWA belirteçlerini takas etmek için kod içeren daha eksiksiz bir çözüm için bkz. LWA token değişimi ile Java SDK oluşturma.

1. Adım: Amazon ile Giriş Yap erişim kodu isteyin

Amazon ile Giriş Yap (LWA) erişim kodu, uygulamanızı satış ortağı adına belirli işlemleri gerçekleştirme konusunda yetkilendirir. LWA erişim kodunun süresi, oluşturulduktan bir saat sonra dolar.

Note about restricted operations. An LWA access token must be included in calls to all operations except restricted operations, which return Personally Identifiable Information (PII). When calling restricted operations, instead of including an LWA access token, you include a Restricted Data Token (RDT). For information about getting RDTs and calling restricted operations, refer to the Tokens API Use Case Guide.

LWA erişim kodu istemek için LWA kimlik doğrulama sunucusuna (https://api.amazon.com/auth/o2/token) aşağıdaki parametreleri kullanarak güvenli bir HTTP POST isteği yapın:

AdAçıklamaZorunlu mu?
grant_type

İstenen erişim izninin türü. Değerler:

  • refresh_token. Use this for calling operations that require authorization from a selling partner. All operations that are not grantless operations require authorization from a selling partner. When specifying this value, include the refresh_token parameter.

  • client_credentials. Bunu aramak için kullanın bağışsız operasyonlar. Bu değeri belirtirken, şunları ekleyin scope parametresi.

Evet
refresh_tokenLWA yenileme belirteci. Satış ortağı başvurunuzu yetkilendirdiğinde bu değeri alın. Daha fazla bilgi için bkz. Satış Ortağı API uygulamalarını yetkilendirme.Hayır. Satış ortağı yetkilendirmesi gereken çağrı işlemleri için refresh_token öğesini ekleyin. refresh_token eklediğinizde scope eklemeyin.
scope

LWA yetkilendirme izninin kapsamı. Değerler:

  • sellingpartnerapi::notifications. Bildirimler API'si için.

  • sellingpartnerapi::client_credential:rotation. Uygulama Yönetimi API'si için.

Hayır. İzinsiz işlem çağırmak için scope ekleyin. scope eklerseniz refresh_token eklemeyin.
client_idBaşvurunuzu kaydettiğinizde bu değeri alın. Bakınız Geliştirici bilgilerinizi görüntüleme.Evet
client_secretBaşvurunuzu kaydettiğinizde bu değeri alın. Bakınız Geliştirici bilgilerinizi görüntüleme.Evet

Satış ortağı yetkilendirmesi gereken bir işlemi çağırmayla ilgili örnek:

POST /auth/o2/token HTTP/l.l Host: api.amazon.com Content-Type: application/x-www-form-urlencoded;charset=UTF-8 grant_type=refresh_token &refresh_token=Aztr|... &client_id=foodev &client_secret=Y76SDl2F

İzinsiz işlem çağırmayla ilgili örnek:

POST /auth/o2/token HTTP/l.l Host: api.amazon.com Content-Type: application/x-www-form-urlencoded;charset=UTF-8 grant_type=client_credentials &scope=sellingpartnerapi::notifications &client_id=foodev &client_secret=Y76SDl2F

İpucu: LWA yetkilendirme sunucusunu çağırırken güvenilmeyen sertifika yetkilisi (CA) hatası almamamak için uygulamanızın, LWA yetkilendirme sunucusuna güveneceği şekilde güvenilir sertifika deponuzu güncelleyin.

Yanıt

Başarılı bir yanıtta aşağıdaki değerler yer alır.

AdAçıklama
access_tokenLWA erişim kodu. Maksimum boyut: 2048 bayt.
token_typeDöndürülen kodun türü. Taşıyıcı olması gerekir.
expires_inLWA erişim kodu geçersiz hale gelmeden önceki saniye sayısı.
refresh_tokenİstekte gönderdiğiniz LWA yenileme kodu. Maksimum boyut: 2048 bayt.
HTTP/l.l 200 OK Content-Type: application/json;charset UTF-8 Cache-Control: no-store Pragma:no-cache { "access_token":"Atza|IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSREXAMPLE", "token_type":"bearer", "expires_in":3600, "refresh_token":"Atzr|IQEBLzAtAhRPpMJxdwVz2Nn6f2y-tpJX2DeXEXAMPLE" }

Daha fazla bilgi için Amazon ile Giriş Yap belgelerindeki Yetkilendirme Kodu Verme sayfasını ziyaret edin.

2. Adım: Satış Ortağı API URI'si oluşturun

Satış Ortağı API URI'sinin bileşenleri aşağıda verilmiştir.

AdAçıklamaÖrnek
HTTP yöntemiHTTP yöntemi.GET
Uç noktaSatış Ortağı API'si uç noktası.https://sellingpartnerapi-na.amazon.com
PathSatış Ortağı API'sinin bölümü/sürümü. Bölümün/kaynağın numarası./fba/inbound/v0/shipments/{shipmentId}/preorder/confirm
Sorgu dizesiSorgu parametreleri.?marketplace=ATVPDKIKX0DER
Yol parametresiYol parametreleri.shipmentId1

Örneğin:

PUT https://sellingpartnerapi-na.amazon.com/fba/inbound/v0/shipments/shipmentId1/preorder/confirm?MarketplaceId=ATVPDKIKX0DER&NeedByDate=2020-10-10

3. Adım: URI'ye başlık ekleyin

2. Adım: Satış Ortağı API URI'si oluşturun aşamasında oluşturduğunuz URI'ye başlık ekleyin. Satış Ortağı API'sine yaptığınız isteklere eklediğiniz HTTP başlıkları şunlardır:

İstek başlıkları

AdAçıklama
hostPazar yeri uç noktası. Bakınız Satış Ortağı API uç noktaları.
x-amz-access-tokenLWA erişim belirteci. Bakınız Adım 1. Amazon erişim belirteci ile Oturum Açma Talep Edin.
Kısıtlanmış işlemler hakkında not. Kısıtlanmış bir işlem çağırıyorsanız, buraya bir LWA erişim belirteci yerine Kısıtlanmış Veri Belirteci (RDT) iletin. RDT'leri alma ve kısıtlanmış işlemleri çağırma hakkında bilgi için bkz. Token API Kullanım Örneği Kılavuzu Tokens API Kullanım Örneği Kılavuzu'nda.
x-amz-dateİsteğinizin tarihi ve saati.
user-agentUygulama adınız ve sürüm numaranız, platformunuz ve programlama diliniz. Bunlar, Amazon'un hizmetle karşılaşabileceğiniz sorunları teşhis etmesine ve düzeltmesine yardımcı olur. Bakınız Tüm isteklere bir User-Agent başlığı ekleyin.

URI ve başlıklar içeren ancak imzalama bilgileri içermeyen, Satış Ortağı API'sine yapılmış istekle ilgili bir örnek aşağıda verilmiştir:

PUT /fba/inbound/v0/shipments/shipmentId1/preorder/confirm?MarketplaceId=ATVPDKIKX0DER&NeedByDate=2020-10-10 HTTP/1.1 host: sellingpartnerapi-na.amazon.com user-agent: My Selling Tool/2.0 (Language=Java/1.8.0.221; Platform=Windows/10) x-amz-access-token=Atza|IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSREXAMPLE x-amz-date: 20190430T123600Z

Bu sayfa size yardımcı oldu mu?