인증

모든 API 요청에는 Bearer 토큰으로 전달하는 유효한 API 키가 필요해요.

Bearer 토큰

모든 요청의 Authorization 헤더에 API 키를 넣어 인증하세요:

http

Authorization: Bearer YOUR_API_KEY

API 키는 ev_로 시작하는 긴 문자열이에요. 예시:

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API 키 찾는 방법

다음 주소에서 계정에 로그인하세요: 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 키가 필요하신가요? 대시보드에서 추가 키를 발급할 수 있어요.