邮件 OTP

通过电子邮件验证，基于真实的邮件网络。

立即开始阅读文档

配置语言：

CursorCopied!

邮件验证会向电子邮件地址发送一次性验证码：无需手机号码，该渠道可触达任何拥有收件箱的用户。Bird 通过承载大规模事务性邮件的同一基础设施发送验证码，支持共享发件人或您自己的已验证域名，并按收件人进行校验。

verify.ts

200 · pending

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({
  apiKey: process.env.BIRD_API_KEY!,
});

// Send the code, then check it by recipient.
await bird.verify.verifications.create({
  to: { email: "ada@example.com" },
}).safe();

const { data, error } = await bird.verify.verifications.check({
  to:   { email: "ada@example.com" },
  code: userInput,
}).safe();
if (error) throw error;

verify.ts

200 · pending

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({
  apiKey: process.env.BIRD_API_KEY!,
});

// Send the code, then check it by recipient.
await bird.verify.verifications.create({
  to: { email: "ada@example.com" },
}).safe();

const { data, error } = await bird.verify.verifications.check({
  to:   { email: "ada@example.com" },
  code: userInput,
}).safe();
if (error) throw error;

无需手机号码的验证渠道。

Email 是 Bird Verify API 上的一等渠道：提交一个包含电子邮件地址的验证请求，我们即通过 Bird 托管的共享发件人发送验证码，默认为 otp@verify.bird.com 或 Authifly 的 otp@verify.authifly.com，也可使用您自己的已验证域名发送。它不受国家/地区限制，全球通用，并依托 Bird 用于大规模事务性邮件的同一网络运行。

邮件验证为您提供的功能。

内置于每次发送中。

01
按邮箱地址寻址。
只需传入一个电子邮件地址。无需手机号码，无需国家信息：电子邮件是唯一能触达任何拥有收件箱用户的渠道。
02
共享域名或您自己的域名。
开箱即用，通过 Bird 托管的共享发件人发送（otp@verify.bird.com 或 Authifly 的 otp@verify.authifly.com），也可切换为您已验证的自有域名进行发送。
03
一封开箱即用的 OTP 邮件。
验证码会以简洁、适配移动端的默认模板发送：验证码醒目展示，附带过期提示和切勿分享的安全提醒。无需设计，即可上线。
04
基于 Bird 邮件网络。
您的验证码使用与产品事务性邮件相同的投递基础设施：经过签名、路由和监控。
05
服务器生成的哈希加密验证码。
默认为 6 位数字验证码（可配置 4–10 位），由加密随机源生成，仅以 HMAC 形式存储。
06
按收件人校验。
通过验证码发送到的电子邮件地址来确认验证码：无需保留验证 ID，在会话内重新发起创建请求即可重新发送验证码。

发送到一个地址，用同一地址校验。

邮件验证与其他渠道一样，只需两次 API 调用：唯一的区别是收件人格式从手机号码变为电子邮件地址。

email-otp.ts

200

await bird.verify.verifications.create({
  to: { email: "ada@example.com" },
}).safe();

const { data, error } = await bird.verify.verifications.check({
  to:   { email: "ada@example.com" },
  code: userInput,
}).safe();
if (error) throw error;

// data.success is true or false; data.reason elaborates ("incorrect_code", "expired", "attempts_exhausted")

Verify 平台的更多功能

一套 API，一组密钥。探索其他功能。

SMS OTP通过 SMS 发送一次性验证码，覆盖全球，内置速率限制。WhatsApp OTPWhatsApp 作为可排序渠道，包含在同一套餐中发送验证码。语音 OTP即将推出：为固定电话和难以触达的用户提供语音播报验证码。渠道编排Per-country channel order and senders, resolved automatically and tunable per request.防滥用与验证码安全哈希验证码、单用户频率限制、尝试锁定以及反欺诈路线图。Verify API 概览The full Verify API: create-or-retry, check by target, and advance to the next channel.

在运行您邮件的网络上发送验证码。

电子邮件是 Bird Verify 的渠道之一：SMS 和 WhatsApp 已内置支持，语音渠道正在逐步上线，所有渠道共用同一组两个端点。

探索 Verify 平台立即开始

通过电子邮件验证， 基于真实的邮件网络。