文件/寄件者驗證

寄件者驗證

所有 API 請求都需要以 Bearer token 傳送有效的 API 金鑰。

檢視 Markdown OpenAPI JSON

Bearer Token

在每個請求的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 金鑰？可以從控制台產生更多金鑰。