認証

すべてのAPIリクエストには、Bearerトークンとして渡す有効なAPIキーが必要です。

Bearerトークン

すべてのリクエストのAuthorizationヘッダーにAPIキーを含めて認証します:

http

Authorization: Bearer YOUR_API_KEY

APIキーは、ev_で始まる長い文字列です。例:

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

APIキーの確認方法

次のURLからアカウントにログインします: verimails.com/dashboard
次の画面に移動します: 設定 → APIキー
キーをコピーします

⚠️

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キーが必要ですか？ダッシュボードから追加のキーを発行できます。