如何获取VS Code扩展的版本更新信息

获取VS Code 扩展的版本更新的需求

因为企业内部有架设私有扩展管理器的要求，但是对于一些官方市场的插件，希望可以自动获取这些扩展的更新并上传至私有扩展管理器。于是就有了本篇介绍的需求： 通过API的方式获取VS Code 扩展的更新。

关于VS Code的私有扩展管理器可以参考：
VS Code 扩展之——私有扩展管理(Private Extension Manager)

获取VS Code 扩展的版本的方式

VS Code 的官方扩展市场的地址是： https://marketplace.visualstudio.com/。

每个插件的页面在 “Version History” 的标签也可以看到各个版本并且进行下载。

如何通过API获取这些版本信息并且下载最新版本呢？ 使用网络爬虫去爬页面有是一种方法，但是VS Code提供了一个最便捷的方式， 就是其提供了一个https的接口：https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery。

为了演示方便，这里使用 Postman 来呼叫这个接口， 以获取“Test Runner for Java“ 的扩展的版本为例。

用 Postman 查询 Test Runner for Java 插件的版本信息，需要配置一个 POST 请求，包括设置必要的 Headers 和 Body。详细的步骤如下：

1. 打开 Postman。
2. 创建一个新的请求。
3. 设置请求方法为 POST。
4. 将 URL 设置为 https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery。
   5.** 在 Headers 部分添加如下信息：**

   Content-Type: application/json
   Accept: application/json;api-version=6.0-preview.1
   

注意： 这里一定要将Accept设置为正确，否则调用的时候会出现下面的 No api-version was supplied for the \"POST\" request 错误。

6. 在 Body 部分，选择 raw 并设置类型为 JSON。

7. 输入请求体（需要使用Test Runner for Java的插件发布者和插件标识符）：

{
  "filters": [
    {
      "criteria": [
        { "filterType": 7, "value": "vscjava.vscode-java-test" }
      ]
    }
  ],
  "flags": 103
}

请注意

• vscjava.vscode-java-test 是插件的 ID。
• filterType 设为 7 表示我们按照扩展的唯一标识符来过滤结果
• flags 值为 103 是请求返回包括版本信息、资产详情等在内的一系列详细信息的标志位。

8. 点击发送（Send）按钮。

Postman 将会发送一个 POST 请求到 Visual Studio Marketplace 的扩展查询 API，并会显示查询结果。在响应体中看到包含 Test Runner for Java 插件的详细信息的 JSON，其中就包含了版本号信息。

正确返回的结果如下：

错误解决之 No api-version was supplied for the “POST” request

{
    "$id": "1",
    "innerException": null,
    "message": "No api-version was supplied for the \"POST\" request. The version must be supplied either as part of the Accept header (e.g. \"application/json; api-version=1.0\") or as a query parameter (e.g. \"?api-version=1.0\").",
    "typeName": "Microsoft.VisualStudio.Services.WebApi.VssVersionNotSpecifiedException, Microsoft.VisualStudio.Services.WebApi",
    "typeKey": "VssVersionNotSpecifiedException",
    "errorCode": 0,
    "eventId": 3000
}

---

---