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

Europe(ロンドン)リージョンバケットへの事前署名付きダイレクト S3 URL。

url_ap-southeast-2string

Asia Pacific(シドニー)リージョンバケットへの事前署名付きダイレクト 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"
}