邮箱验证 API
通过简洁的 REST API 购买一次性邮箱地址以接收 OTP 验证码。与短信端点采用相同的 JSON 约定和相同的 API 密钥，位于 /v1/email-activations 命名空间下。
基础 URL
https://smsbulk.net/api/v1/email-activations一个 API 密钥同时适用于短信和邮箱。如果你已集成短信 API，邮箱使用同一个密钥即可。
身份验证
每个请求都需携带 API 密钥。支持两种可互换的方式：
# 1. Header (recommended)
curl https://smsbulk.net/api/v1/email-activations \
-H "x-api-key: YOUR_KEY"
# 2. Bearer token
curl https://smsbulk.net/api/v1/email-activations \
-H "Authorization: Bearer YOUR_KEY"请通过请求头 (x-api-key) 或 Bearer 令牌发送密钥。出于安全考虑，不建议将其作为 URL 查询参数传递，因为查询字符串通常会被记录到服务器和代理日志中。
你的短信 API 密钥与此处使用的密钥相同，没有单独的邮箱密钥。
端点
/api/v1/email-activations 下的六个路由。价格面向用户；绝不返回批发成本。
列出目标站点可用的邮箱服务商域名，含面向用户的价格和库存。
curl "https://smsbulk.net/api/v1/email-activations/domains?site=telegram.com" \
-H "x-api-key: YOUR_KEY"[
{ "name": "gmx.com", "price": 0.04, "count": 12, "currency": "USD" }
]为站点/域名组合预订一个邮箱地址。立即从钱包扣款，并返回状态为 WAITING 的激活记录。
curl -X POST https://smsbulk.net/api/v1/email-activations \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "site": "telegram.com", "domain": "gmx.com" }'{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "WAITING",
"otpValue": null,
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"createdAt": "2026-06-03T13:45:00Z"
}返回你最近的邮箱激活记录，最新的在前。默认 50，最多 100，无游标分页。
curl "https://smsbulk.net/api/v1/email-activations?limit=50" \
-H "x-api-key: YOUR_KEY"[
{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "RECEIVED",
"otpValue": "595348",
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"receivedAt": "2026-06-03T13:47:12Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}
]获取单条激活记录。收到后包含解析出的 OTP 和原始 HTML 邮件正文。
curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
-H "x-api-key: YOUR_KEY"{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "RECEIVED",
"otpValue": "595348",
"htmlMessage": "<html>Your code is 595348</html>",
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"receivedAt": "2026-06-03T13:47:12Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}为新的 OTP 重新开启同一地址。会再次从钱包扣款（相当于短信的重新发送）。
curl -X POST https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd/reorder \
-H "x-api-key: YOUR_KEY"{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "WAITING",
"otpValue": null,
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:20:00Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}如果邮件服务商封禁了该地址，reorder 会以 502 和代码 EMAIL_BANNED 失败，扣款将被退回。此后该激活在列表、详情和 reorder 响应中带有 reorderBlockedAt 字段（ISO 日期，否则为 null），之后每次 reorder 都会返回 409 和代码 EMAIL_BANNED，且不会扣款。请改为购买新地址。
HTTP 409 Conflict
{
"statusCode": 409,
"code": "EMAIL_BANNED",
"message": "Email address blocked by the provider; reorder is not possible"
}取消激活。若未收到 OTP，则退款至你的钱包。
curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
-H "x-api-key: YOUR_KEY"{
"ok": true
}如果该激活的 reorder 卡住未完成，取消不会取消激活，而是退还 reorder 的扣款。响应为 200，带有 reorderRefunded: true 和代码 EMAIL_REORDER_REFUNDED，原地址仍然有效。
HTTP 200 OK
{
"ok": true,
"reorderRefunded": true,
"code": "EMAIL_REORDER_REFUNDED",
"message": "Reorder failed and was refunded. Your original email address is still active."
}如果该激活的 reorder 仍在进行中，取消会返回 409、代码 EMAIL_REORDER_IN_PROGRESS 以及 retryAfterSec（需等待的秒数）。不会取消任何内容，也不会扣款；请在该时间后重试。
HTTP 409 Conflict
{
"statusCode": 409,
"code": "EMAIL_REORDER_IN_PROGRESS",
"message": "A reorder is in progress. Try again in a moment.",
"retryAfterSec": 90
}说明与限制
- 每日配额由短信和邮箱共享：每个 API 密钥每个 UTC 日 10,000 次请求。
- 列表端点最多返回 100 行（默认 50），且按设计不提供游标分页。
- 忠诚度折扣会自动应用到扣款价格。userCost 反映你实际支付的金额。