使用 HTTP 调用设置电子邮件验证

Logto 的官方 HTTP 邮件连接器。

提示:

本指南假设你对 Logto 连接器 (Connectors) 有基本的了解。对于不熟悉的人，请参考 连接器 (Connectors) 指南以开始了解。

入门

HTTP 邮件连接器允许你通过 HTTP 调用发送电子邮件。要使用 HTTP 邮件连接器，你需要拥有自己的电子邮件服务，该服务提供用于发送电子邮件的 HTTP API。当 Logto 需要发送电子邮件时，它将调用此 API。例如，当用户注册时，Logto 将调用 HTTP API 发送验证电子邮件。

设置 HTTP 邮件连接器

要使用 HTTP 邮件连接器，你需要设置一个 Logto 可以调用的 HTTP 端点。以及一个可选的端点授权令牌。

负载

HTTP 邮件连接器在触发电子邮件时会向端点发送负载。它包括收件人的电子邮件地址 (to)、指示认证 (Authentication) 流程的电子邮件 usageType (type)，以及包含可用 变量（例如，验证码、链接、应用信息、组织信息、用户信息）和用户 locale 的 payload。

示例：

{
  "to": "foo@logto.io",
  "type": "SignIn",
  "payload": {
    "code": "123456"
    "locale": "de"
  }
}

你可以使用这些信息在你的电子邮件发送服务提供商中自定义电子邮件模板。

有关所有可用类型，请参见 电子邮件模板。完整的 SendMessageData 类型定义在 connector-kit 中。