API Resources

GET
/v4/backup/{feed}

특정 피드의 백업 다운로드 URL 조회

/v4/backup/{feed}

요청된 피드가 존재하는지 확인하고, 해당 피드의 백업 zip에 대한 사전 서명된 S3 다운로드 URL을 반환합니다. 멀티 리전 액세스 포인트 URL(url_mrap)과 US(url_us-east-1), UK(url_eu-west-2), 호주(url_ap-southeast-2)의 직접 리전 버킷 URL 총 4개가 반환됩니다. 모든 URL은 15분 후 만료됩니다.

V3 동등 엔드포인트는 /v3/backup/{index}로, V3 인덱스 백업의 다운로드 링크를 반환합니다.

경로 파라미터

feedstring

어드바이저리 피드 이름(예: ghsa). 사용 가능한 피드 목록은 /v4/backup에서 확인할 수 있습니다.

요청 예시

curl --request GET \
  --url 'https://api.vulncheck.com/v4/backup/ghsa' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer insert_token_here'

응답 속성

feedstring

요청된 피드 이름.

availableboolean

이 피드의 백업 zip이 존재하는지 여부.

url_mrapstring

백업 zip 다운로드용 사전 서명된 멀티 리전 액세스 포인트 URL. 가장 가까운 리전으로 자동 라우팅됩니다.

url_us-east-1string

US East(버지니아 북부) 리전 버킷의 사전 서명된 직접 S3 URL.

url_eu-west-2string

유럽(런던) 리전 버킷의 사전 서명된 직접 S3 URL.

url_ap-southeast-2string

아시아 태평양(시드니) 리전 버킷의 사전 서명된 직접 S3 URL.

url_expiresstring (RFC3339)

사전 서명된 URL의 만료 UTC 타임스탬프.

url_ttl_minutesinteger

사전 서명된 URL의 유효 시간(분).

sha256string

백업 zip의 SHA256 16진수 다이제스트(사용 가능한 경우).

오류 처리

상태 코드의미
401인증 토큰이 누락되었거나 유효하지 않음
404피드를 찾을 수 없음
503백업 서비스를 사용할 수 없음

응답

{
  "feed": "ghsa",
  "available": true,
  "url_mrap": "https://mrap.accesspoint.s3.amazonaws.com/v4DataBackups/ghsa.zip?...",
  "url_us-east-1": "https://s3.us-east-1.amazonaws.com/vcnova-data-full.../v4DataBackups/ghsa.zip?...",
  "url_eu-west-2": "https://s3.eu-west-2.amazonaws.com/vclon-data-full.../v4DataBackups/ghsa.zip?...",
  "url_ap-southeast-2": "https://s3.ap-southeast-2.amazonaws.com/vcsyd-data-full.../v4DataBackups/ghsa.zip?...",
  "url_expires": "2026-03-20T12:15:00Z",
  "url_ttl_minutes": 15,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}