文档/身份验证

身份验证

所有 API 请求都需要以 Bearer 令牌形式传入有效的 API 密钥。

查看 Markdown OpenAPI JSON

Bearer 令牌

在每个请求的Authorization请求头中加入 API 密钥，即可完成身份验证：

http
Authorization: Bearer YOUR_API_KEY

API 密钥是一串以ev_开头的长字符串。例如：

http
Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

在哪里找到 API 密钥

  1. 登录账户： verimails.com/dashboard
  2. 前往设置 → API 密钥
  3. 复制密钥
⚠️
请妥善保管 API 密钥。切勿将其写入客户端 JavaScript、公开代码仓库，或分享给不受信任的人。如果密钥泄露，请立即在控制台重新生成。

已验证身份的请求示例

bash
curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

身份验证错误

如果密钥缺失或无效，将收到401 Unauthorized响应：

json
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}
ℹ️
需要为不同环境或应用使用多个 API 密钥？可以在控制台生成更多密钥。