View a markdown version of this page

Menggunakan AWS Marketplace API Penemuan - AWS Marketplace
Titik Akhir LayananVersi APIModel DataAutentikasiMembuat permintaanFormat responsMenggunakan AWS SDKPaginasiThrottling

Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API AWS Marketplace.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan AWS Marketplace API Penemuan

AWS Marketplace Discovery API menyediakan akses terprogram ke AWS Marketplace katalog. Anda dapat menggunakannya untuk mengambil informasi produk dan harga, membangun pengalaman pengadaan terintegrasi, dan membuat etalase khusus.

Titik Akhir Layanan

Discovery API menggunakan format endpoint berikut:

https://discovery-marketplace.region.api.aws

Misalnya, untuk memanggil API di AS Timur (Virginia N.):

https://discovery-marketplace.us-east-1.api.aws

Versi API

Versi API saat ini adalah2026-02-05.

Model Data

Discovery API mengatur AWS Marketplace katalog ke dalam entitas berikut:

  • Listing — Solusi produk atau multi-produk seperti yang terlihat oleh pembeli. Daftar mencakup deskripsi, sorotan, kategori, lencana, model harga, unit harga, ulasan, media promosi, keterlibatan penjual, jenis opsi pemenuhan, dan referensi ke produk dan penawaran terkait. Gunakan GetListing untuk mengambil daftar, atau SearchListings untuk mencari di seluruh daftar.

  • Produk — Perangkat lunak atau layanan yang mendasari yang dijual. Produk mencakup deskripsi, sorotan, kategori, media promosi, keterlibatan penjual, dan opsi pemenuhan yang menjelaskan bagaimana pembeli dapat menyebarkan atau mengakses produk (seperti AMI, SaaS, Container, atau Helm). Gunakan GetProduct untuk mengambil detail produk dan ListFulfillmentOptions untuk mengambil opsi pemenuhan rinci untuk suatu produk.

  • Penawaran — Pengaturan harga untuk suatu produk, termasuk model harga, penjual catatan, tanggal ketersediaan, dan lencana. Penawaran berisi persyaratan komersial seperti harga berbasis penggunaan, harga di muka tetap, periode uji coba gratis, dokumen hukum, jadwal pembayaran, dan ketentuan perpanjangan. Gunakan ListPurchaseOptions untuk menemukan semua penawaran yang tersedia untuk suatu produk, GetOffer untuk mengambil rincian penawaran, dan GetOfferTerms untuk mengambil persyaratan khusus dari penawaran.

  • Set penawaran — Kumpulan penawaran pribadi yang dikelompokkan untuk setiap produk dalam solusi multi-produk. Set penawaran memungkinkan pembeli meninjau semua penawaran bersama dan menerimanya secara bersamaan dengan satu tindakan. Gunakan ListPurchaseOptions untuk menemukan semua set penawaran yang tersedia GetOfferSet untuk suatu produk, untuk mengambil rincian set penawaran, GetOffer untuk mengambil rincian penawaran, dan GetOfferTerms untuk mengambil persyaratan tertentu dari penawaran.

Autentikasi

Discovery API menggunakan otentikasi AWS Signature Version 4 (SigV4) standar. Anda harus memiliki AWS kredensi yang valid dan izin IAM yang sesuai untuk memanggil API. Lihat perinciannya di Kontrol akses untuk AWS Marketplace API Penemuan.

Membuat permintaan

Semua operasi Discovery API menggunakan POST metode HTTP dengan badan permintaan JSON. Nama operasi ditentukan dalam jalur URL.

Format respons

Semua tanggapan dikembalikan dalam format JSON. Tanggapan yang berhasil mengembalikan kode status HTTP 200. Tanggapan kesalahan mencakup jenis kesalahan dan pesan. Untuk detailnya, lihat Kesalahan Umum.

Menggunakan AWS SDK

Cara yang disarankan untuk memanggil Discovery API adalah melalui AWS SDK. SDK menangani autentikasi, penandatanganan permintaan, serialisasi, dan penanganan kesalahan secara otomatis.

# Python (Boto3) example
import boto3

client = boto3.client('marketplace-discovery', region_name='us-east-1')

response = client.get_listing(
    listingId='listing-saas-abc123'
)

print(response['listingName'])
// JavaScript (AWS SDK v3) example
import { MarketplaceDiscoveryClient, GetListingCommand } from "@aws-sdk/client-marketplace-discovery";

const client = new MarketplaceDiscoveryClient({ region: "us-east-1" });
const response = await client.send(new GetListingCommand({
    listingId: "listing-saas-abc123"
}));

console.log(response.listingName);

Paginasi

Operasi yang mengembalikan daftar (seperti ListPurchaseOptions danSearchFacets) mendukung pagination menggunakannextToken. Jika respons menyertakan nextToken nilai, teruskan dalam permintaan berikutnya untuk mengambil hasil tambahan.

Throttling

Discovery API memberlakukan batas tarif permintaan untuk memastikan ketersediaan layanan. Jika Anda melebihi batas tarif, API akan mengembalikan ThrottlingException (HTTP 429). Terapkan backoff eksponensial dan coba lagi logika dalam aplikasi Anda.