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:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
grant_type | İstenen erişim izninin türü. Değerler:
| Evet |
refresh_token | LWA 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:
| Hayır. İzinsiz işlem çağırmak için scope ekleyin. scope eklerseniz refresh_token eklemeyin. |
client_id | Başvurunuzu kaydettiğinizde bu değeri alın. Bakınız Geliştirici bilgilerinizi görüntüleme. | Evet |
client_secret | Baş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.
Ad | Açıklama |
---|---|
access_token | LWA erişim kodu. Maksimum boyut: 2048 bayt. |
token_type | Döndürülen kodun türü. Taşıyıcı olması gerekir. |
expires_in | LWA 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.
Ad | Açıklama | Örnek |
---|---|---|
HTTP yöntemi | HTTP yöntemi. | GET |
Uç nokta | Satış Ortağı API'si uç noktası. | https://sellingpartnerapi-na.amazon.com |
Path | Satış Ortağı API'sinin bölümü/sürümü. Bölümün/kaynağın numarası. | /fba/inbound/v0/shipments/{shipmentId}/preorder/confirm |
Sorgu dizesi | Sorgu parametreleri. | ?marketplace=ATVPDKIKX0DER |
Yol parametresi | Yol 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ı
Ad | Açıklama |
---|---|
host | Pazar yeri uç noktası. Bakınız Satış Ortağı API uç noktaları. |
x-amz-access-token | LWA 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-agent | Uygulama 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
6 gün önce güncellendi