设置 Postman 以与 Amazon Pinpoint 配合使用

创建工作区

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

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

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

创建环境

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

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

3. 在管理环境窗口中，对于环境名称，输入 Amazon Pinpoint - Region Name。将区域名称替换为以下值之一：

   • 美国东部（弗吉尼亚州北部）

   • 美国西部（俄勒冈州）

   • 亚太地区（孟买）

   • 亚太地区（悉尼）

   • 欧洲地区（法兰克福）

   • 欧洲地区（爱尔兰）

   注意

   您至少需要为单个 AWS 区域创建一个环境，并且该 AWS 区域必须包含一个项目。如果您尚未在前面列出的 AWS 区域中创建项目，请参阅《Amazon Pinpoint 用户指南》中的创建带有电子邮件支持的 Amazon Pinpoint 项目。

4. 创建六个新变量：endpoint、region、serviceName、accountId、accessKey 和 secretAccessKey。使用下表确定要在每个变量的初始值和当前值列中输入哪个值。

   区域	变量	初始值和当前值
   美国东部（弗吉尼亚州北部）	endpoint	pinpoint.us-east-1.amazonaws.com
   	region	us-east-1
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）
   美国西部（俄勒冈州）	endpoint	pinpoint.us-west-2.amazonaws.com
   	region	us-west-2
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）
   亚太地区（孟买）	endpoint	pinpoint.ap-south-1.amazonaws.com
   	region	ap-south-1
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）
   亚太地区（悉尼）	endpoint	pinpoint.ap-southeast-2.amazonaws.com
   	region	ap-southeast-2
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）
   欧洲地区（法兰克福）	endpoint	pinpoint.eu-central-1.amazonaws.com
   	region	eu-central-1
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）
   欧洲地区（爱尔兰）	endpoint	pinpoint.eu-west-1.amazonaws.com
   	region	eu-west-1
   	serviceName	mobiletargeting
   	accountId	（您的 AWS 账户 ID）
   	accessKey	（您的 IAM 访问密钥 ID）
   	secretAccessKey	（您的 IAM 秘密访问密钥）

   创建这些变量后，管理环境窗口类似于下图所示的示例。

   

   完成后，选择保存。

   重要

   上图所示的访问密钥是虚构的。不要与他人共享您的 IAM 访问密钥。

   Postman 包含允许您共享和导出环境的功能。如果您使用这些功能，切勿与不应访问这些凭证的任何人分享您的访问密钥 ID 和秘密访问密钥。

   有关更多信息，请参阅《IAM 用户指南》中的 IAM 最佳实践。

5. （可选）对于您要创建的每个额外环境，请重复步骤 1-4。

   提示

   在 Postman 中，您可以根据需要创建任意多个环境。您可以通过以下方式使用环境：

   • 为必须进行 Amazon Pinpoint API 测试的每个区域创建一个单独的环境。

   • 创建与不同的 AWS 账户账户关联的环境。

   • 创建使用与其他用户关联的凭证的环境。

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

创建 Amazon Pinpoint 集合

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

2. 在导入窗口中，选择从链接导入，然后输入以下 URL：https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json。

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

测试 Amazon Pinpoint 集合的配置

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

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

3. 使用环境选择器选择您在创建 Postman 环境中创建的环境。

4. 选择发送。如果请求成功发送，则响应窗格显示 200 OK 状态。您将看到一个类似于下图中的示例的响应。

   

   注意

   如果您没有在 AWS 区域中创建任何项目，那么 Amazon Pinpoint 就会返回 { "Item": [] }。

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