Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi API AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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
<a name="discovery-apis"></a>

 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
<a name="discovery-service-endpoint"></a>

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
<a name="discovery-api-version"></a>

Versi API saat ini adalah`2026-02-05`.

## Model Data
<a name="discovery-data-model"></a>

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
<a name="discovery-authentication"></a>

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](discovery-api-access-control.md).

## Membuat permintaan
<a name="discovery-making-requests"></a>

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

## Format respons
<a name="discovery-response-format"></a>

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](https://docs.aws.amazon.com//marketplace/latest/APIReference/CommonErrors.html).

## Menggunakan AWS SDK
<a name="discovery-using-sdk"></a>

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
<a name="discovery-pagination"></a>

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

## Throttling
<a name="discovery-throttling"></a>

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.