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 titik akhir berikut:

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

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

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:

  • Daftar — Produk atau solusi 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 menerapkan atau mengakses produk (seperti AMI, SaaS, Container, atau Helm). Gunakan GetProduct untuk mengambil detail produk dan ListFulfillmentOptions untuk mengambil opsi pemenuhan terperinci 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 spesifik dari penawaran.

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

Autentikasi

Discovery API menggunakan otentikasi standar Sig AWS nature Version 4 (SIGv4). Anda harus memiliki AWS kredenSIAL 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 di jalur URL.

Format respons

Semua tanggapan dikembalikan dalam format JSON. Respons yang berhasil mengembalikan kode status HTTP 200. Respons 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 otentikasi, 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 penggunaan pagination. nextToken Jika respons menyertakan nextToken nilai, berikan pada permintaan berikutnya untuk mengambil hasil tambahan.

Throttling

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