Satıcılar API v1 Kullanım Örneği Kılavuzu
Satıcı hesabı ve pazar yeri bilgilerini alın.
API Sürümü: V1
Satıcılar API'si nedir?
Satıcılar için Satış Ortağı API'si (Satıcılar API'si) satıcı hesapları ve pazar yerleri hakkında bilgi sağlar. İade edilen bilgiler şunları içerir:
- Satıcının öğeleri listeleyebileceği pazar yerleri
- Bir pazarın varsayılan dili ve para birimi
- Satıcının listeleri askıya alıp almadığı
- Satıcının iş bilgileri
Satıcılar API'sinin işlemleri, veri türleri ve şemaları hakkında ayrıntılar için bkz. Satıcılar API v1 Referansı.
Eğitim: Bir satıcının hesap bilgilerini alın (yalnızca AB)
Bir satıcının hesap bilgilerini nasıl alacağınızı öğrenin. Aldığınız bilgiler, pazar yeri katılımlarının bir listesini, işletme bilgilerini ve satış planı ayrıntılarını içerir. Bu yalnızca AB bölgesinde mevcuttur.
Ön koşullar
Bu öğreticiyi tamamlamak için aşağıdaki önkoşulları tamamlamanız gerekir:
- Satış ortağı, kendi adına Satış Ortağı API'sini (SP-API) çağırmanız için size yetki vermelidir. Satış ortaklarının SP-API'yi kendi adlarına çağırmak için bir uygulamayı nasıl yetkilendirebilecekleri hakkında ayrıntılı bilgi için bkz. Satış Ortağı API Uygulamalarını Yetkilendirme.
- Geliştirici profiliniz şunları içermelidir: Finans ve Muhasebe rolü. Roller hakkında bilgi edinmek için bkz. Satış Ortağı API'sındaki Roller.
- Başvurunuz için uygulama kayıt sayfası şunları içermelidir: Finans ve Muhasebe rolü.
Hesap bilgilerini al
getAccount
işlemini çağırın.
İstek parametreleri
Hiçbiri.
İstek örneği
GET /sellers/v1/account
Yanıt özellikleri
Başarılı bir yanıtta aşağıdaki özellikler yer alır:
Ad | Açıklama | Schema |
---|---|---|
business | Satıcının işi hakkında bilgi. Satıcıya bağlı olarak businessType , belirli alanları atlayabilirsiniz. | Business |
businessType | Satıcı hesabının kayıtlı olduğu işletme türü. | Tür: (BusinessType ) |
marketplaceParticipationList | Pazar yeri katılımlarının bir listesi. | < MarketplaceParticipationList > array |
primaryContact | Satıcının birincil irtibat kişisi hakkında bilgi. | PrimaryContact |
sellingPlan | Satış planı detayları. | Tür: (SellingPlan ) |
Yanıt örneği
{
"businessType": "PRIVATE_LIMITED",
"marketplaceParticipationList": [
{
"marketplace": {
"id": "ATVPDKIKX0DER",
"name": "United States",
"countryCode": "US",
"domainName": "www.amazon.com"
},
"storeName": "BestSellerStore",
"participation": {
"isParticipating": true,
"hasSuspendedListings": false
}
}
],
"sellingPlan": "PROFESSIONAL",
"business": {
"name": "BestSeller Inc.",
"nonLatinName": "ベストセラー株式会社",
"registeredBusinessAddress": {
"addressLine1": "123 Main St",
"addressLine2": "Suite 500",
"city": "Seattle",
"stateOrProvinceCode": "WA",
"postalCode": "98101",
"countryCode": "US"
},
"companyRegistrationNumber": "123456789",
"companyTaxIdentificationNumber": "987654321"
},
"primaryContact": {
"name": "John Doe",
"nonLatinName": "ジョン・ドゥ",
"address": {
"addressLine1": "456 Oak St",
"addressLine2": "Apt 12",
"city": "Seattle",
"stateOrProvinceCode": "WA",
"postalCode": "98102",
"countryCode": "US"
}
}
}
Eğitim: Bir satıcının pazar katılımını alın
Satıcının öğeleri listeleyebileceği Amazon pazar yerlerinin listesini nasıl alacağınızı öğrenin. Aldığınız bilgiler arasında pazar yeri bilgileri, satıcının pazardaki mağaza adı, satıcının pazara katılıp katılmadığı ve satıcının pazardaki listeleri askıya alıp almadığını içerir.
Ön koşullar
Bu öğreticiyi tamamlamak için aşağıdaki önkoşulları tamamlamanız gerekir:
- Satış ortağı, kendi adına Satış Ortağı API'sini (SP-API) çağırmanız için size yetki vermelidir. Satış ortaklarının SP-API'yi kendi adlarına çağırmak için bir uygulamayı nasıl yetkilendirebilecekleri hakkında ayrıntılı bilgi için bkz. Satış Ortağı API Uygulamalarını Yetkilendirme.
- Geliştirici profiliniz şunları içermelidir: Finans ve Muhasebe rolü. Roller hakkında bilgi edinmek için bkz. Satış Ortağı API'sındaki Roller.
- Başvurunuz için uygulama kayıt sayfası şunları içermelidir: Finans ve Muhasebe rolü.
- Veri istediğiniz pazarın pazar yeri tanımlayıcısı. Pazar yeri tanımlayıcılarının listesi için bkz. Pazar yeri kimlikleri.
Pazara katılım sağlayın
getMarketplaceParticipations
işlemini çağırın.
İstek parametreleri
Hiçbiri.
İstek örneği
GET /sellers/v1/marketplaceParticipations
Yanıt
Başarılı bir yanıtta aşağıdaki öğeler yer alır:
Ad | Açıklama | Schema |
---|---|---|
marketplaceParticipationList | Satıcının öğeleri listeleyebileceği ve müşterilerin öğeleri görüntüleyebileceği ve satın alabileceği Amazon pazar yerlerinin listesi. | < MarketplaceParticipationList > array |
Yanıt örneği
[
{
"marketplace": {
"id": "ATVPDKIKX0DER",
"name": "Amazon.com",
"countryCode": "US",
"defaultCurrencyCode": "USD",
"defaultLanguageCode": "en_US",
"domainName": "www.amazon.com"
},
"storeName": "BestSellerStore",
"participation": {
"isParticipating": true,
"hasSuspendedListings": false
}
}
]
Updated about 2 months ago