유해 URL 탐지
보안/안전 서비스 중URL을 분석하여 스팸, 도박, 성인물 등 유해 여부를 판별합니다.
API 키 필수
HTTPS
POST
/api/v1/url/detect
API 설명
유해 URL 탐지 API는 지능형 AI 모델을 통해 입력된 URL의 패턴, 도박/성인 키워드, 악성 코드 유포지 여부 등을 실시간으로 분석합니다.
- 스팸 및 피싱 사이트 감지
- 불법 도박 및 성인 콘텐츠 판별
- 불건전 키워드 기반 탐지
- 실시간 유해 카테고리 분류
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/url/detect
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| url | String | Y | 분석할 URL 주소 (http/https 포함) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| is_malicious | Boolean | 유해 여부 (true/false) |
| category | String | 탐지된 유해 카테고리 (clean, gambling, spam 등) |
| reason | String | 판정된 상세 사유 |
### 오류 코드
| 코드 | 메시지 | 설명 |
| :--- | :--- | :--- |
| 400 | Bad Request | URL 누락 또는 잘못된 형식 |
| 401 | Unauthorized | 유효하지 않은 API Key |
### 응답 예시
```json
{
"success": true,
"is_malicious": true,
"category": "gambling",
"reason": "불법 도박 사이트 패턴 감지"
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/url/detect \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https:\/\/example.com\/very-long-url-to-shorten"}'