벌크 IP 조회 API 레퍼런스
POST/v1/lookup
GET /v1/lookup/{ip}의 배치 버전입니다 — 단일 백엔드 요청으로 최대 100개의 IPv4/IPv6 주소를 확인하며, 제출한 순서와 동일한 순서로 결과를 반환합니다.
인증
Authorization: Bearer YOUR_SECRET_KEY로 시크릿 키를 전달하세요 — 단일 IP 조회 엔드포인트와 동일한 키 유형입니다.
요청 본문
- ips
- 1~100개의 IPv4/IPv6 주소 문자열로 이루어진 배열입니다. 조회를 실행하기 전에 배치 전체가 검증됩니다 — 잘못된 형식의 주소가 하나라도 있으면 호출 전체가 실패합니다.
오류
- 400
- 빈 ips 배열, 100개를 초과하는 IP, 또는 배열 어딘가에 잘못된 형식의 IP가 있는 경우입니다.
- 401
- API 키가 없거나 유효하지 않습니다.
- 403
- 시크릿 키 대신 공개 가능 키가 사용되었습니다.
- 429
- 현재 1분 윈도우의 속도 제한을 초과했습니다.
예시
요청
curl https://api.watch-ip.com/v1/lookup \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"ips": ["203.0.113.1", "2001:db8::1"]}'응답
{
"results": [
{ "ip": "203.0.113.1", "country": "US", "region": "TX", "city": "Austin", "postalCode": null, "latitude": 30.2672, "longitude": -97.7431, "continent": "NA", "timezone": null, "found": true },
{ "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
]
}제한 사항
배치 내 각 IP는 개별적으로 과금되고 기록됩니다 — 100개 IP를 요청한 호출은 하나가 아니라 100개의 lookup 사용 이벤트로 기록됩니다. 동일한 IP를 두 번 제출하면 두 번 과금됩니다. 분당 속도 제한에서는 호출 전체가 1건의 요청으로 계산됩니다. 이 엔드포인트의 위치 데이터는 DB-IP가 제공합니다(IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).