**终止支持通知：** 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 API Postman 是一种在 easy-to-use图形环境 APIs 中进行测试的常用工具。您可以使用 Postman 向任何 REST API 发送 API 请求，并接收对请求的响应。使用 Postman 可以方便地测试和排查您对 Amazon Pinpoint API 进行的调用。本教程包含设置 Postman 和将 Postman 用于 Amazon Pinpoint API 的过程。 **注意** Postman 是由第三方公司开发的，而不是由 Amazon Web Services (AWS) 开发或支持的。要了解有关使用 Postman 的更多信息，或需要帮助以解决与 Postman 相关的问题，请参阅 Postman 网站上的[支持中心](https://support.postman.com/hc/en-us)。 ## 关于本教程 此部分包含本教程的概述。 **目标受众** 本教程适用于开发人员和系统实施者。虽然您不必非得熟悉 Amazon Pinpoint 或 Postman 才能完成本教程中的步骤，但您应熟悉管理 IAM 策略和修改 JSON 代码示例。 本教程中的过程旨在防止新用户使用可永久删除 Amazon Pinpoint 资源的 API 操作。高级用户可通过修改与其用户关联的策略来删除此限制。 **使用的功能** 本教程包含以下 Amazon Pinpoint 功能的使用示例： + 通过使用 Postman 与 Amazon Pinpoint API 交互 **所需时间** 完成本教程大约需要 15 分钟。 **区域限制** 没有与使用此解决方案关联的区域限制。 **资源用量费用** 创建 AWS 账户不收取任何费用。但是，通过实施此解决方案，如果您 AWS 使用 Postman 执行以下任一操作，则可能会产生使用成本： + 发送电子邮件、SMS、移动推送或语音消息 + 创建和发送活动 + 使用电话号码验证功能 有关与使用 Amazon Pinpoint 关联的费用的更多信息，请参阅 [Amazon Pinpoint 定价](https://aws.amazon.com/pinpoint/pricing/)。 # 将 Postman 与 Amazon Pinpoint 结合使用的先决条件 开始本教程之前，请完成以下先决条件： + 您必须具有 AWS 账户。要创建 AWS 账户，请前往 [https://console.aws.amazon.com/](https://console.aws.amazon.com/) 并选择**创建新的 AWS 账户**。 + 确保用于登录 AWS 管理控制台 的账户能够创建新的 IAM 策略和角色。 + 确保您创建了至少一个示例项目，该项目已开启电子邮件并具有经过验证的电子邮件身份。请参阅《Amazon Pinpoint 用户指南》中的[创建带有电子邮件支持的 Amazon Pinpoint 项目](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html)。** + 确保您具有 AWS 账户 ID。可以在控制台的右上角找到您的 AWS 账户 ID，或者，您可以使用命令行界面 (CLI) 查找。请参阅[查找您的 AWS 账户 ID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)。 + 您必须在计算机上下载并安装 Postman。您可以从 [Postman 网站](https://www.getpostman.com)下载 Postman。 + 在计算机上安装 Postman 后，您必须创建一个 Postman 账户。当您首次启动 Postman 应用程序时，系统会提示您登录或创建新账户。请按照 Postman 提供的说明登录您的账户，或者，如果您还没有此账户，则创建一个。 **下一步**：[创建 IAM 策略和角色](tutorials-using-postman-iam-user.md) # 创建 IAM 策略和角色以用于 Amazon Pinpoint 当您使用 Postman 测试 Amazon Pinpoint API 时，第一步是创建用户。在本部分，您将创建一个策略，以允许用户能够与所有 Amazon Pinpoint 资源交互。然后，您创建一个用户，并将该策略直接附加到该用户。 ## 创建 IAM 策略 了解如何创建 IAM 策略。使用此策略的用户和角色能够与 Amazon Pinpoint API 中的所有资源交互。它还允许访问与 Amazon Pinpoint Email API 以及 Amazon Pinpoint SMS 和 Voice API.相关的资源。 **创建策略** 1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。 1. 在导航窗格中，选择 **策略**，然后选择 **创建策略**。 1. 在**策略编辑器**中，选择 **JSON**。删除**策略编辑器**中当前的任何 JSON，使其为空。将以下 JSON 复制并粘贴到**策略编辑器**中，然后在**策略编辑器**中将的所有实例替换为您的 AWS 账户 ID。*123456789012* 你的 AWS 账户 ID 可以在控制台的右上角找到，或者你可以使用 CLI，参见[查找你的 AWS 账户 ID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)。 **注意** 为保护您的 Amazon Pinpoint 账户中的数据，此策略仅包含允许您读取、创建和修改资源的权限，不包含删除资源的权限。您可以在 IAM 控制台中使用可视化编辑器来修改此策略。有关更多信息，请参阅《IAM 用户指南》中的[管理 IAM 策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)。您也可以使用 IAM API 中的[CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)操作来更新此政策。 另请注意，除了 `mobiletargeting` 服务外，此策略还包含允许您与 `ses` 和 `sms-voice` 服务交互的权限。`ses` 和 `sms-voice` 权限允许您分别与 Amazon Pinpoint Email API 以及 Amazon Pinpoint SMS 和 Voice API 进行交互。`mobiletargeting` 权限允许您与 Amazon Pinpoint API 交互。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ 选择**下一步**。 1. 对于**策略名称**，输入策略的名称，如 **PostmanAccessPolicy**。选择**创建策略**。 1. （可选）您可以通过选择**添加标签**将标签添加到策略。 1. 选择**下一步：审核**。 ## 创建 IAM 用户 **警告** IAM 用户具有长期凭证，这会带来安全风险。为帮助减轻这种风险，我们建议仅向这些用户提供执行任务所需的权限，并在不再需要这些用户时将其移除。 创建策略后，您可以创建用户并将策略附加到该用户。当您创建用户时，IAM 会提供一组凭证，以允许 Postman 执行 Amazon Pinpoint API 操作。 **创建用户** 1. 使用 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 打开 IAM 控制台。 1. 在 IAM 控制台的导航窗格中，选择**用户**，然后选择**创建用户**。 1. 在**用户详细信息**下，对于**用户名**，输入用于标识用户的名称，如 **PostmanUser**。然后选择**下一步**。 1. 在**设置权限**下，对于**权限选项**，选择**直接附加策略**。 1. 在**权限策略**下，选择您在[创建 IAM 策略](#tutorials-using-postman-iam-user-create-policy)中创建的策略（**PostmanAccessPolicy**）。然后选择**下一步**。 1. 在**审核和创建**页面上，您也可以添加有助于标识用户的标签。有关使用标签的更多信息，请参阅《IAM 用户指南》**中的[标记 IAM 资源](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html)。 1. 当您准备好创建用户时，请选择**创建用户**。 ## 创建访问密钥 **警告** 此场景需要 IAM 用户具有编程访问权限和长期凭证，这会带来安全风险。为帮助减轻这种风险，我们建议仅向这些用户提供执行任务所需的权限，并在不再需要这些用户时将其移除。必要时可以更新访问密钥。有关更多信息，请参阅《IAM 用户指南》**中的[更新访问密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html)。 IAM 提供了一组凭证，您可以使用这些凭证来允许 Postman 执行 Amazon Pinpoint API 操作。 **创建用户** 1. 使用 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 打开 IAM 控制台。 1. 在 IAM 控制台的导航窗格中，选择**用户**。选择在[创建 IAM 用户](#tutorials-using-postman-iam-user-create-user)中创建的用户（**PostmanUser**），然后选择**安全凭证**选项卡。 1. 在**访问密钥**部分，选择**创建访问密钥**。 1. 在**访问密钥最佳实践和替代方案**页面上，选择**在 AWS之外运行的应用程序**。 然后选择**下一步**。 1. （可选）您可以向策略中添加描述标签。 1. 选择**创建访问密钥**。 1. 在**检索访问密钥**页面上，复制**访问密钥**和**秘密访问密钥**列中显示的凭证。 **注意** 在本教程的后面部分，您需要提供在此访问密钥 ID 和秘密访问密钥。这是您可以查看秘密访问密钥的唯一机会。建议您复制它并保存到安全的位置。 1. 保存两个密钥后，选择**完成**。 **下一步**：[设置 Postman](tutorials-using-postman-configuration.md) # 设置 Postman 以与 Amazon Pinpoint 配合使用 现在，您已经创建了一个能够访问 Amazon Pinpoint API 的用户，接下来可以设置 Postman 了。在本部分，您将在 Postman 中创建一个或多个环境。接下来，您将导入一个集合，其中包含 Amazon Pinpoint API 中的每项操作的请求模板。 ## 创建 Postman 工作区 在 Postman 中，*工作区* 是项目和环境的组织容器。在本节中，您将至少创建一个工作区以与 Amazon Pinpoint 配合使用。 **创建工作区** 在 Postman 中，选择更多操作，选择**文件**，然后选择**新建**。 1. 在**新建**窗口中，选择**工作区**。 1. 输入名称和摘要，并将可见性设置为个人。选择**创建工作区**。 ## 创建 Postman 环境 在 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 集合 在 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 配置 导入 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 项目的列表。 ### 问题排查 当您提交请求时，可能会看到错误。请查看以下列表，了解可能会遇到的几个常见错误，以及可以采取的解决问题的步骤。 | 错误消息 | 问题 | 解决方案 | | --- | --- | --- | | 无法得到任何响应 连接 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) # 向 Amazon Pinpoint API 发送请求 当您完成配置和测试 Postman 后，可以开始向 Amazon Pinpoint API 发送其他请求。本部分包括开始发送请求之前需要了解的信息。它还包括两个示例请求，描述了如何使用 Amazon Pinpoint 集合。 **重要** 当您完成本部分中的过程时，您就将请求提交给了 Amazon Pinpoint API。这些请求在您的 Amazon Pinpoint 账户中创建新的资源、修改现有资源、发送消息、更改 Amazon Pinpoint 项目配置并使用其他 Amazon Pinpoint 功能。执行这些请求时要小心。 ## Amazon Pinpoint Postman 集合中的示例 对于 Amazon Pinpoint Postman 集合中的大多数操作，您必须先进行配置，然后才能使用它们。对于 `GET` 和 `DELETE` 操作，通常只需修改**预请求脚本**选项卡上设置的变量即可。 **注意** 当您使用[创建 IAM 策略](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)中显示的 IAM 策略时，您无法执行此集合中包含的任何 `DELETE` 请求。 例如，`GetCampaign` 操作要求您指定一个 `projectId` 和 `campaignId`。在**预请求脚本**选项卡上，这两个变量都存在，并填充了示例值。删除示例值，并将它们替换为您的 Amazon Pinpoint 项目和活动的相应值。 在这些变量中，最常用的是 `projectId` 变量。此变量的值应该是您的请求应用到的项目的唯一标识符。要获取项目的这些标识符的列表，您可以参考在本教程的前一步骤中发送的 `GetApps` 请求的响应。在该响应中，`Id` 字段提供了项目的唯一标识符。要详细了解 `GetApps` 操作和响应中每个字段的含义，请参阅《Amazon Pinpoint API 参考》中的**[应用程序](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html)。 **注意** 在 Amazon Pinpoint 中，“项目”与“应用程序”同义。 对于 `POST` 和 `PUT` 操作，您还需要修改请求正文，以包含要发送到 API 的值。例如，当您提交 `CreateApp` 请求（一个 `POST` 请求）时，必须为创建的项目指定一个名称。您可以在**正文**选项卡上修改请求。在本示例中，将 `"Name"` 旁边的值替换为项目的名称。如果您要将标签添加到项目中，可以在 `tags` 对象中指定它们。或者，如果您不想添加标签，可以删除整个 `tags` 对象。 **注意** `UntagResource` 操作还要求您指定 URL 参数。您可以在**参数**选项卡上指定这些参数。将**值**列中的值替换为您要为指定资源删除的标签。 ## 示例请求：通过使用 `CreateApp` 操作来创建项目 在 Amazon Pinpoint 中创建客户细分和活动之前，您必须先创建一个项目。在 Amazon Pinpoint 中，一个*项目* 由出于一个共同目的而联合的客户细分、活动、配置和数据组成。例如，您可以使用一个项目来包含与特定应用程序或者与特定品牌或营销计划相关的所有内容。当您向 Amazon Pinpoint 添加客户信息时，该信息与一个项目相关联。 **通过发送 CreateApp API 请求创建项目** 1. 在 “**环境**” 菜单上 AWS 区域 ，选择要在其中创建项目的。 ![\[\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) 在本示例中，Postman 已进行配置，因此 **Environments (环境)** 菜单显示以下四个选项： + 美国东部（弗吉尼亚州北部） + 美国西部（俄勒冈州） + 欧洲地区（法兰克福） + 欧洲地区（爱尔兰） 1. 在**应用程序**文件夹中，选择**CreateApp**操作>。 ![\[\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) Amazon Pinpoint Postman 集合中的**应用程序**文件夹展开并显示以下请求： + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. 在**正文**选项卡上，`"Name"` 的旁边，将占位符值 (`"string"`) 替换为活动的名称，例如 **"MySampleProject"**。 1. 删除活动名称后面的逗号，然后删除第 3 至 5 行上的整个 `tags` 对象。完成后，您的请求应类似于以下代码片段中所示的示例。 ``` { "Name": "MySampleProject" } ``` Postman 配置为发送请求作为原始 JSON 负载。 1. 选择**发送**。如果活动成功创建，则响应窗格将显示 `201 Created` 状态。 ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## 示例：通过使用 `SendMessages` 操作来发送电子邮件 使用 Amazon Pinpoint `SendMessages` API 发送事务性消息非常常见。通过使用 `SendMessages` API（而不是创建活动）来发送消息的一个优势是，您可以将消息发送到任何地址，如电子邮件地址、电话号码或设备令牌。消息发往的地址不必存在于您的 Amazon Pinpoint 账户中。我们来将这种方法与通过创建活动发送消息的方法进行比较。在 Amazon Pinpoint 中发送活动之前，您必须先将端点添加到您 的 Amazon Pinpoint 账户中，然后创建客户细分，创建活动，并执行活动。 本部分中的示例演示如何将事务性电子邮件直接发送到特定电子邮件地址。您可以修改此请求，以通过其他渠道（如短信、移动推送或语音）发送消息。 **通过提交 SendMessages 请求发送电子邮件** 1. 确认项目已启用电子邮件渠道，并配置了要用于发送和接收邮件的电子邮件地址或域。有关更多信息，请参阅《Amazon Pinpoint 用户指南》中的**[启用和禁用电子邮件渠道](pinpoint/latest/userguide/channels-email-setup.html)和[验证电子邮件身份](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html)。 **注意** 要完成本节中的过程，您必须验证电子邮件地址 1. 在 “**环境**” 菜单上 AWS 区域 ，选择要从中发送消息的。 在本示例中，Postman 已进行配置，因此 **Environments (环境)** 菜单显示以下四个选项： + 美国东部（弗吉尼亚州北部） + 美国西部（俄勒冈州） + 欧洲地区（法兰克福） + 欧洲地区（爱尔兰） 1. 在 “**消息**” 文件夹中，选择**SendMessages**操作。 ![\[\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. 在**预请求脚本**选项卡上，将 `projectId` 变量的值替换为您在本部分步骤 2 中选择的区域内已存在的项目的 ID。 1. 在**正文**选项卡上，删除请求编辑器中显示的示例请求。粘贴以下代码： ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. 在前面的代码中，*sender@example.com*替换为经过验证的电子邮件地址。*recipient@example.com*替换为要将邮件发送到的经过验证的电子邮件地址。 **注意** 如果您的账户仍在 Amazon Pinpoint 电子邮件沙盒中，则您只能将电子邮件发送到在您的 Amazon Pinpoint 账户中验证过的地址或域。有关将您的账户从沙盒移除的更多信息，请参阅《Amazon Pinpoint 用户指南》**中的[请求电子邮件的生产访问权限](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html)。 1. 选择**发送**。如果消息成功发送，则响应窗格显示 `200 OK` 状态。 ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```