인증
Watch-IP는 호출하는 엔드포인트에 따라 두 가지 키 유형을 사용합니다 — 클라이언트 측 호출을 위한 브라우저에 안전한 공개 가능 키와, 백엔드 호출을 위한 서버 전용 시크릿 키입니다. 잘못된 유형의 키를 보내면 부분적인 응답이 아니라 401 또는 403이 반환됩니다.
공개 가능 키(브라우저에 안전)
GET /v1/geo와 POST /v1/email/validate에 사용되며, 두 엔드포인트 모두 방문자의 브라우저에서 직접 호출하도록 설계되었습니다. X-Api-Key 헤더로 전달하세요(GET /v1/geo는 대체 수단으로 key 쿼리 파라미터도 허용합니다). 이 키는 비밀이 아닙니다 — 페이지의 JavaScript에 그대로 노출되며, 실제로 중요한 통제 수단은 해당 키에 설정된 오리진 허용 목록으로, 요청의 Origin/Referer 헤더와 대조하여 확인됩니다. 허용 목록에 없는 오리진에서 온 요청은 CORS 헤더가 설정되지 않은 채 403을 받습니다 — 브라우저가 코드에 응답이 도달하기 전에 차단하며, 이것이 JSON 오류 본문이 아니라 실제 집행 수단입니다.
공개 가능 키
curl https://api.watch-ip.com/v1/geo \
-H "X-Api-Key: YOUR_PUBLISHABLE_KEY"시크릿 키(서버 전용)
GET /v1/lookup/{ip}, POST /v1/lookup, POST /v1/risk/check에 사용되며, 이들은 모두 확인할 브라우저 Origin이 없는 서버 간(server-to-server) 엔드포인트입니다. Authorization: Bearer YOUR_SECRET_KEY 형태로 자체 백엔드에서만 전송하세요. 페이지, 모바일 앱 번들, 또는 통제할 수 없는 클라이언트에는 시크릿 키를 절대 포함하지 마세요. 시크릿 키 전용 경로에 공개 가능 키를 사용하거나, 공개 가능 키 전용 경로에 시크릿 키를 사용하면 403이 반환됩니다.
시크릿 키
curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
-H "Authorization: Bearer YOUR_SECRET_KEY"속도 제한
모든 키는 고정된 1분 단위 윈도우로 고객 계정별 속도 제한이 적용되며, 라우트별로 개별 추적되는 것이 아니라 호출하는 모든 엔드포인트에 걸쳐 공유됩니다. 한도를 초과하면 429가 반환됩니다 — 응답 형태와 대기(백오프) 방법은 오류 및 속도 제한 문서를 참고하세요. 분당 속도 제한은 항목 수가 아니라 HTTP 호출 수를 셉니다. 최대 100개의 IP 또는 이메일 주소를 담은 배치는 1건의 요청으로 계산되며, 각 항목은 여전히 월간 요청 한도에 개별적으로 계산됩니다.
커스텀 도메인
Growth 및 Scale 요금제에는 대시보드에서 커스텀 도메인을 설정할 수 있는 경로가 포함되어 있어, 요청을 api.watch-ip.com 대신 자체 도메인의 호스트명으로 보낼 수 있습니다. 이용 가능 여부는 계정 자격과 DNS/SSL 설정의 성공 여부에 따라 달라집니다 — 대시보드에서 활성 상태로 확인된 기본 URL로 통합을 연결하세요.