Watch-IP

빠른 시작

몇 분 만에 작동하는 GET /v1/geo 호출을 만들어 보세요: 키를 생성하고, 요청을 보내고, 응답을 확인합니다.

시작하기 전에

  • Watch-IP 계정 — 이 가이드를 따라가기에는 무료 요금제로 충분합니다.
  • fetch나 curl 호출을 추가할 수 있는 페이지 또는 스크립트.

1. 계정을 만들고 키를 받으세요

가입 후 대시보드를 여세요. 모든 계정은 공개 가능한 방문자 키로 시작합니다 — 호출할 사이트(또는 테스트 중이라면 localhost)를 허용된 오리진에 포함하도록 설정하세요.

2. 첫 요청을 보내세요

X-Api-Key 헤더에 공개 가능 키를 담아 GET /v1/geo를 호출하세요. 브라우저에서 호출하면 방문자 자신의 연결을 확인하고, 서버에서 호출하면 서버 자신의 연결을 확인합니다.

curl

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

3. 응답을 확인하세요

성공한 호출은 JSON 본문과 함께 200을 반환합니다 — country, city, timezone은 대부분의 통합에서 가장 먼저 사용하는 필드이며, 모든 필드는 각각 독립적으로 null이 될 수 있으므로 사용하기 전에 확인하세요.

응답 (일부)

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. 다른 IP 조회하기

연결된 방문자가 아니라 이미 가지고 있는 주소를 확인해야 하나요? 이는 공개 가능 키가 아니라 시크릿 키로 인증하는 별도의 서버 간 통신 엔드포인트입니다 — IP 조회 레퍼런스를 참고하세요.

문제가 발생했다면

401은 API 키가 없거나 유효하지 않다는 뜻입니다. GET /v1/geo에서의 403은 대개 호출한 오리진이 아직 키의 허용된 오리진 목록에 없다는 뜻입니다. 전체 상태 코드 목록은 오류 및 속도 제한 문서를 참고하세요.

다음 단계

키 유형과 오리진 제한이 어떻게 작동하는지는 인증 문서를 읽고, 통합 중인 응답의 엔드포인트 레퍼런스로 바로 이동해도 좋습니다.

관련 페이지