AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

设置和身份验证

使用AWS合作伙伴中心 API 进行设置和身份验证包括三个步骤。以下是该过程的概述：

链接你的AWS 账户前往合作伙伴中心

将您链接AWS 账户到合作伙伴中心是使用 API 的先决条件。有关更多信息，请参阅将AWS合作伙伴平台账户与AWS Marketplace卖家账户关联起来。您必须使用具有联盟领导权限或云管理员权限的账户登录合作伙伴中心，导航至该Account Linking部分，然后按照提示进行操作。

设置 IAM

要使用AWS合作伙伴中心 API，您需要一个AWS Identity and Access Management(IAM) 角色或 IAM 用户才能开始拨打电话。有关更多信息，请参阅何时使用 IAM？ 。请按照AWS 账户指南中创建 IAM 角色和创建 IAM 用户的步骤进行操作。您必须在您的合作伙伴 Central-linked AWS Marketplace卖家账户 Role/User 中创建此 IAM。 role/user 创建 IAM 不会产生任何费用。

管理AWS Marketplace优惠

要管理AWS Marketplace优惠并将其与机会关联起来，合作伙伴必须授予 IAM 角色访问目录 API 的权限。确保 role/user 具有权限，例如aws-marketplace:ListEntities和aws-marketplace:SearchAgreements。

对 API 调用进行身份验证

AWS合作伙伴中心 API 使用签名版本 4 (Sigv4) 进行身份验证。以下是实现它的方法：

使用AWS SDK

AWS SDK 会自动处理请求签名。提供您的AWS凭证，剩下的就交给 SDK。

不使用进行身份验证AWS SDK

如果您选择的编程语言没有可用的AWS SDK，则身份验证包括手动创建规范请求、对请求进行签名和处理会话令牌。AWS为使用 SigV4 签名提供了全面的指导。但是，请注意，建议使用AWS软件开发工具包，因为手动请求签名会增加复杂性，并且需要仔细管理安全令牌。

每个对 awsjson1_0 协议的请求都必须使用以下标头使用 HTTP “POST” 方法发送到根 URL (/)。

必需的标头

每个 AWSJson1_0 协议的 API 请求都必须使用以下标头使用 HTTP “POST” 方法发送到根网址 (/)。

使用自定义用户代理对通话进行签名

在向 P AWS artner Central 提出 API 请求时，我们建议添加X-Amzn-User-Agent标题以帮助AWS识别客户端应用程序的来源、监控使用情况和审计绩效。AWS使用此标头来区分发出调用的客户端应用程序的类型，并收集有关不同客户端实现成功率的见解。

自定义用户代理标头

标题名称：X-Amzn-User-Agent

目的：区分发出 API 请求的客户端类型，对交互来源进行分类。

Format: {Integrator}|{Product}

示例值：AWS|AWS Partner CRM Connector

在每个请求中都包含此标头可以AWS分析请求模式、跟踪集成并改善不同客户端系统的 API 体验。

在 SDK 中使用自定义标头

要在 SDK 调用中包含X-Amzn-User-Agent标头，您可以在调用 API 之前修改客户端请求行为。以下是使用适用于 Python 的AWS SDK (Boto3) 的销售 API 示例：

import boto3

# Define service and endpoint details
service_name = "partnercentral-selling"
endpoint_url = "https://partnercentral-selling.us-east-1.api.aws"

# Create a boto3 client for Partner Central
partner_central_client = boto3.client(
service_name=service_name,
='us-east-1',
endpoint_url=endpoint_url
)

# Function to add the custom User-Agent header

def add_version_header(params, **kwargs):
params["headers"]['X-Amzn-User-Agent'] = 'AWS|AWS Partner CRM Connector'

# Register the event to modify the request before the call is made
partner_central_client.meta.events.register(
f'before-call.{service_name}.*', add_version_header
)

# Now, whenever an API call is made using this client, the custom User-Agent header will be included

此示例演示如何在 Boto3 SDK 中注册事件，以自动将X-Amzn-User-Agent标头附加到每个 API 请求。通过修改其各自的请求拦截机制，可以将同样的方法应用于其他AWS SDK。