**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

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

# 设置 Postman 以与 Amazon Pinpoint 配合使用
<a name="tutorials-using-postman-configuration"></a>

现在，您已经创建了一个能够访问 Amazon Pinpoint API 的用户，接下来可以设置 Postman 了。在本部分，您将在 Postman 中创建一个或多个环境。接下来，您将导入一个集合，其中包含 Amazon Pinpoint API 中的每项操作的请求模板。

## 创建 Postman 工作区
<a name="tutorials-using-postman-configuration-create-workspace"></a>

在 Postman 中，*工作区* 是项目和环境的组织容器。在本节中，您将至少创建一个工作区以与 Amazon Pinpoint 配合使用。

**创建工作区**

在 Postman 中，选择更多操作，选择**文件**，然后选择**新建**。

1. 在**新建**窗口中，选择**工作区**。

1. 输入名称和摘要，并将可见性设置为个人。选择**创建工作区**。

## 创建 Postman 环境
<a name="tutorials-using-postman-configuration-create-environments"></a>

在 Postman 中，*环境* 是一组存储为键/值对的变量。您可以使用环境来更改通过 Postman 发出的请求的配置，而无需更改 API 请求本身。

在本部分，您将创建至少一个环境以与 Amazon Pinpoint 配合使用。您创建的每个环境都包含一组变量，这些变量特定于您在单个 AWS 区域中的账户。如果您使用本部分中的过程创建多个环境，则可通过从 Postman 的**环境**菜单中选择不同的环境，在不同区域之间轻松切换。

**创建环境**

1. 在 Postman 中，选择更多操作菜单，选择**文件**，然后选择**新建**。

1. 在**新建**窗口中，选择**环境**。

1. 在**管理环境**窗口中，对于**环境名称**，输入 **Amazon Pinpoint - *Region Name***。*Region Name*替换为以下值之一：
   + 美国东部（弗吉尼亚州北部）
   + 美国西部（俄勒冈州）
   + 亚太地区（孟买）
   + 亚太地区（悉尼）
   + 欧洲地区（法兰克福）
   + 欧洲地区（爱尔兰）
**注意**  
您至少只需要为单个环境创建一个环境 AWS 区域，并且该环境 AWS 区域 必须包含一个项目。如果您尚未在前面列出的项目中创建项目 AWS 区域，请参阅亚马逊 Pinp [oint 用户指南中的使用电子邮件支持创建亚马*逊 Pinpoin* t 项目](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html)。

1. 创建六个新变量：`endpoint`、`region`、`serviceName`、`accountId`、`accessKey` 和 `secretAccessKey`。使用下表确定要在每个变量的**初始值**和**当前值**列中输入哪个值。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/tutorials-using-postman-configuration.html)

   创建这些变量后，**管理环境**窗口类似于下图所示的示例。  
![\[\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png)

   完成后，选择**保存**。
**重要**  
上图所示的访问密钥是虚构的。不要与他人共享您的 IAM 访问密钥。  
Postman 包含允许您共享和导出环境的功能。如果您使用这些功能，切勿与不应访问这些凭证的任何人分享您的访问密钥 ID 和秘密访问密钥。  
有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。

1. （可选）对于您要创建的每个额外环境，请重复步骤 1-4。
**提示**  
在 Postman 中，您可以根据需要创建任意多个环境。您可以通过以下方式使用环境：  
为必须进行 Amazon Pinpoint API 测试的每个区域创建一个单独的环境。
创建与不同的 AWS 账户账户关联的环境。
创建使用与其他用户关联的凭证的环境。

1. 创建完环境后，请继续完成下一部分。

## 在 Postman 中创建 Amazon Pinpoint 集合
<a name="tutorials-using-postman-configuration-create-pinpoint-collection"></a>

在 Postman 中，*集合* 是一组 API 请求。集合中的请求通常由一个共同的目的联系在一起。在本部分，您将创建一个新集合，其中包含 Amazon Pinpoint API 中的每项操作的请求模板。

**创建 Amazon Pinpoint 集合**

1. 在 Postman 中，选择更多操作菜单，选择**文件**，然后选择**导入**。

1. 在 “**导入” 窗口中，选择 “**从链接**导入**”，然后输入以下 URL：[https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon %20pinpoint.post](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) man\$1Collection.json。

   选择**导入**。Postman 将导入 Amazon Pinpoint 集合，其中包含 120 个示例请求。

## 测试 Postman 配置
<a name="tutorials-using-postman-configuration-test-operation"></a>

导入 Amazon Pinpoint 集合后，建议您执行快速测试，以确认所有组件是否都配置正确。可以通过提交 `GetApps` 请求来测试您的配置。此请求将返回当前 AWS 区域内您的 Amazon Pinpoint 账户中存在的所有项目的列表。此请求不需要任何额外配置，因此这是一种测试配置的好办法。

**测试 Amazon Pinpoint 集合的配置**

1. 在左侧导航窗格中，选择**集合**，展开 **Amazon Pinpoint** 集合，然后展开**应用程序**文件夹。

1. 在请求列表中，选择**GetApps**。

1. 使用**环境**选择器选择您在[创建 Postman 环境](#tutorials-using-postman-configuration-create-environments)中创建的环境。

1. 选择**发送**。如果请求成功发送，则响应窗格显示 `200 OK` 状态。您将看到一个类似于下图中的示例的响应。  
![\[\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png)
**注意**  
如果你没有在中创建任何项目， AWS 区域 那么 Amazon Pinpoint 就会返回。`{ "Item": [] }`

   此响应显示您在步骤 3 中选择的区域内的账户中存在的所有 Amazon Pinpoint 项目的列表。

### 问题排查
<a name="tutorials-using-postman-configuration-test-operation-troubleshooting"></a>

当您提交请求时，可能会看到错误。请查看以下列表，了解可能会遇到的几个常见错误，以及可以采取的解决问题的步骤。


| 错误消息 | 问题 | 解决方案 | 
| --- | --- | --- | 
|  无法得到任何响应 连接 https://%7B%7Bendpoint%7D%7 时出错D/v1/apps。  |  `{{endpoint}}` 变量当前没有值，在您选择环境时才设置值。  | 使用环境选择器选择一个环境。 | 
|  请求中包含的安全令牌无效。  |  Postman 未能找到您的访问密钥 ID 或秘密访问密钥的当前值。  |  选择环境选择器旁边的齿轮图标，然后选择当前环境。确认 `accessKey` 和 `secretAccessKey` 值显示在**初始值**和**当前值**列中，并且您正确输入了凭证。  | 
|  “消息”：“用户：arn: aws: iam:: 123456789012: user/ 无权执行：mobileTargeting：在资源上：arn: aws: mobileTargeting: us-west-2:123456789012PinpointPostmanUser: \$1” GetApps   |  与您的用户关联的 IAM 策略不包含相应权限。  |  确认您的用户具有在[创建 IAM 策略](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)中所述的权限，并且您在[创建 Postman 工作区](#tutorials-using-postman-configuration-create-environments)中创建环境时提供了正确的凭证。  | 

**下一步**：[发送其他请求](tutorials-using-postman-sample-requests.md)