VulnCheck V4 API는 구조화된 쿼리 인터페이스를 사용하여 어드바이저리 데이터에 직접 접근할 수 있습니다. v3 인덱스 엔드포인트와 달리, v4 엔드포인트는 어드바이저리 데이터 모델에 맞춤화된 일급 쿼리 파라미터를 제공합니다.
모든 V4 API 메서드는 기본 URL로 https://api.vulncheck.com 을 사용합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /v4/advisory | 모든 피드에서 어드바이저리 조회 |
| GET | /v4/advisory/list | 사용 가능한 어드바이저리 피드 이름 목록 반환 |
| GET | /v4/backup | 사용 가능한 백업 피드 목록 |
| GET | /v4/backup/{feed} | 특정 피드의 백업 다운로드 URL 조회 |
| GET | /v4/openapi | V4 API의 OpenAPI 명세 |
모든 V4 엔드포인트에는 Bearer 토큰이 필요합니다. Authorization 헤더에 토큰을 포함하세요:
Authorization: Bearer <your_token>
모든 오류 응답은 일관된 JSON 구조를 따릅니다:
{
"error": true,
"errors": [
"error message here"
]
}
| 상태 코드 | 의미 |
|---|---|
| 400 | 잘못된 파라미터 또는 형식이 잘못된 요청 |
| 401 | 인증 토큰이 누락되었거나 유효하지 않음 |
| 402 | 요청된 데이터에 구독이 필요 |
| 429 | 속도 제한 초과 |
| 503 | 어드바이저리 데이터 소스를 사용할 수 없음 |