AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS Marketplace Discovery API 사용
<a name="discovery-apis"></a>

 AWS Marketplace Discovery API는 AWS Marketplace 카탈로그에 대한 프로그래밍 방식의 액세스를 제공합니다. 이를 사용하여 제품 및 요금 정보를 검색하고, 통합 조달 경험을 구축하고, 사용자 지정 매장을 만들 수 있습니다.

## 서비스 엔드포인트
<a name="discovery-service-endpoint"></a>

Discovery API는 다음 엔드포인트 형식을 사용합니다.

```
https://discovery-marketplace.{{region}}.api.aws
```

예를 들어 미국 동부(버지니아 북부)에서 API를 호출하려면

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

## API 버전
<a name="discovery-api-version"></a>

현재 API 버전은 입니다`2026-02-05`.

## 데이터 모델
<a name="discovery-data-model"></a>

Discovery API는 AWS Marketplace 카탈로그를 다음 개체로 구성합니다.
+ **목록** - 구매자에게 표시되는 제품 또는 다중 제품 솔루션. 목록에는 설명, 하이라이트, 범주, 배지, 요금 모델, 요금 단위, 리뷰, 프로모션 미디어, 판매자 참여, 이행 옵션 유형, 관련 제품 및 제안에 대한 참조가 포함됩니다. `GetListing`를 사용하여 목록을 검색하거나 `SearchListings`를 사용하여 목록 간에 검색합니다.
+ **제품** - 판매 중인 기본 소프트웨어 또는 서비스입니다. 제품에는 구매자가 제품을 배포하거나 액세스하는 방법을 설명하는 설명, 하이라이트, 범주, 프로모션 미디어, 판매자 참여 및 이행 옵션(예: AMI, SaaS, 컨테이너 또는 Helm)이 포함됩니다. `GetProduct`를 사용하여 제품 세부 정보를 검색하고 `ListFulfillmentOptions`를 사용하여 제품에 대한 세부 이행 옵션을 검색합니다.
+ **제안** - 요금 모델, 기록 판매자, 가용성 날짜 및 배지를 포함한 제품의 요금 약정입니다. 제안에는 사용량 기반 요금, 고정 선결제 요금, 무료 평가판 기간, 법률 문서, 결제 일정 및 갱신 조건과 같은 상업적 조건이 포함됩니다. `ListPurchaseOptions`를 사용하여 제품에 사용할 수 있는 모든 제안을 찾고, 제안의 세부 정보를 `GetOffer` 검색하고, 제안의 특정 조건을 `GetOfferTerms` 검색합니다.
+ **제안 세트** - 다중 제품 솔루션의 각 제품에 대한 비공개 제안의 그룹화된 모음입니다. 제안 세트를 사용하면 구매자가 모든 제안을 함께 검토하고 단일 작업으로 동시에 수락할 수 있습니다. `ListPurchaseOptions`를 사용하여 제품에 사용할 수 있는 모든 제안 세트를 찾고, 제안 세트의 세부 정보를 `GetOfferSet` 검색하고, 제안의 세부 정보를 `GetOffer` 검색하고, 제안의 특정 조건을 `GetOfferTerms` 검색합니다.

## Authentication
<a name="discovery-authentication"></a>

Discovery API는 표준 AWS 서명 버전 4(SigV4) 인증을 사용합니다. API를 호출하려면 유효한 AWS 자격 증명과 적절한 IAM 권한이 있어야 합니다. 자세한 내용은 [AWS Marketplace Discovery API에 대한 액세스 제어](discovery-api-access-control.md)을 참조하세요.

## 요청하기
<a name="discovery-making-requests"></a>

모든 Discovery API 작업은 JSON 요청 본문과 함께 HTTP `POST` 메서드를 사용합니다. 작업 이름은 URL 경로에 지정됩니다.

## 응답 형식
<a name="discovery-response-format"></a>

모든 응답은 JSON 형식으로 반환됩니다. 응답이 성공하면 HTTP 상태 코드 200이 반환됩니다. 오류 응답에는 오류 유형과 메시지가 포함됩니다. 자세한 내용은 [일반 오류를 참조하세요](https://docs.aws.amazon.com/marketplace/latest/APIReference/CommonErrors.html).

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

Discovery API를 호출하는 권장 방법은 AWS SDK를 사용하는 것입니다. SDK는 인증, 요청 서명, 직렬화 및 오류 처리를 자동으로 처리합니다.

```
# 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);
```

## 페이지 매김
<a name="discovery-pagination"></a>

목록을 반환하는 작업(예: `ListPurchaseOptions` 및 `SearchFacets`)은를 사용한 페이지 매김을 지원합니다`nextToken`. 응답에 `nextToken` 값이 포함된 경우 다음 요청에서 전달하여 추가 결과를 검색합니다.

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

Discovery API는 요청 속도 제한을 적용하여 서비스 가용성을 보장합니다. 속도 제한을 초과하면 API가 `ThrottlingException` (HTTP 429)를 반환합니다. 애플리케이션에서 지수 백오프 및 재시도 로직을 구현합니다.