IP 정보 조회
네트워크/보안 서비스 중IP 주소의 국가, 지역, ISP 및 예상되는 보안 위험성을 분석합니다.
API 키 필수
HTTPS
POST
/api/v1/ip/info
API 설명
빠르고 정확하게 IP 주소에 대한 지리적 위치(국가, 지역, 도시, 위경도), ASN, ISP 정보를 제공합니다.
- 지역 및 통신사 상세 정보
- AI 분석 연동 가능
- VPN/프록시 및 위협 가능성 평가
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/ip/info
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| ip | String | Y | 조회할 대상 IP 주소 |
| ai_analysis | Boolean | N | AI 분석 포함 여부 (기본값: false) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| ip_info | Object | IP 상세 정보 (하단 참조) |
| ai_analysis | Object | (옵션) AI 분석 결과 (하단 참조) |
| cached | Boolean | 캐시 데이터 사용 여부 |
| api | String | 호출된 API 식별값 |
| remaining | Integer | 잔여 호출 횟수 |
### ip_info 상세 필드
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| ip | String | 조회된 IP 주소 |
| country | String | 국가명 |
| region | String | 지역/시도 명칭 |
| city | String | 도시 명칭 |
| lat / lon | Float | 위도 / 경도 |
| timezone | String | 해당 지역 시간대 |
| isp | String | 인터넷 서비스 제공자 (통신사) |
| org | String | 관련 조직명 |
| asn | String | AS 번호 및 이름 |
### ai_analysis 상세 필드 (ai_analysis: true 요청 시)
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| summary | String | AI가 분석한 해당 IP의 특징 및 보안 위험성 요약 |
| risk_level | String | 위험 수준 판정 (Low, Medium, High) |
### 오류 코드
| 코드 | 메시지 | 설명 |
| :--- | :--- | :--- |
| 400 | Bad Request | IP 주소 누락 또는 잘못된 형식 |
| 401 | Unauthorized | API 키가 누락되었거나 유효하지 않음 |
| 403 | Forbidden | 해당 API를 구독하지 않았음 |
| 404 | Not Found | 조회할 수 없는 IP 주소 |
| 429 | Too Many Requests | 호출 한도를 모두 소진함 |
| 500 | Internal Error | 외부 서버 또는 AI 모델 통신 장애 |
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/ip/info \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip":"8.8.8.8","ai_analysis":true}'