HTTP V2

若需在不依赖开发者工具场景如自身业务工程流水线上进行小程序项目上传、预览，则推荐使用 miniprogram-ci

开发者工具提供了命令行与 HTTP 服务两种接口供外部调用，开发者可以通过命令行或 HTTP 请求指示工具进行登录、预览、上传等操作。

升级说明：自 1.02.202003092 开始，CLI & HTTP 接口升级 v2 版本，在 v2 版本中，旧版命令仍然可以使用，但已废弃并会在未来移除，请使用 v2 命令。v2 版本增加了云开发管理操作支持、优化命令形式、增加细致状态提示、支持长时间命令执行、支持国际化（中英文选择）等。

http 服务在工具启动后自动开启，HTTP 服务端口号在用户目录下记录，可通过检查用户目录、检查用户目录下是否有端口文件及尝试连接来判断工具是否安装/启动。

端口号文件位置：

macOS : ~/Library/Application Support/微信开发者工具//Default/.ide

Windows : ~/AppData/Local/微信开发者工具/User Data//Default/.ide

注： MD5 的计算规则：MD5(`${installPath}${nwVersion}`)

macOS: installPath == "/Applications/wechatwebdevtools.app/Contents/MacOS", nwVersion == '';

Windoes: installPath == '微信开发者工具.exe 所在的路径', nwVersion 是 installPath 目录下有一个 version 文件（JSON 格式）中 latestNw 的值

所有接口的 URL 路径前缀都需 /v2

通用 URL 参数

接口定义：

Path：/v2/login

HTTP 方法：GET

示例：

接口定义：

Path：/v2/islogin

HTTP 方法：GET

示例

接口定义：

URL：/v2/preview

HTTP 方法：GET

示例：

接口定义：

URL：/v2/upload

HTTP 方法：GET

示例：

接口定义：

URL：/autopreview

HTTP 方法：GET

示例：

接口定义：

URL：/buildnpm

HTTP 方法：GET

示例：

接口定义：

URL： /open

HTTP 方法: GET

示例：

注意：

接口定义：

URL：/close

HTTP 方法：GET

示例

注：关闭项目时，会有弹窗提示是否阻止；如未阻止，将在 3 秒后关闭

接口定义：

URL：/quit

HTTP 方法：GET

示例

注：关闭开发者工具时，会有弹窗提示是否阻止；如未阻止，将在 3 秒后关闭

重置工具内部文件缓存，重新监听项目文件。

URL: /resetfileutils

HTTP 方法：GET

示例

接口定义：

URL：/cleancache

HTTP 方法：GET

示例

在云开发命令中，除非特殊说明，均可通过指定 project 选项或 appid （如果是第三方平台则还加上 ext-appid）两者二选一的方式进行指定项目。

示例：

示例：

示例：

示例：

示例：

示例：