---
title: "安装模块"
method: POST
path: "/modules/install"
tags: ["模块"]
---

# 安装模块

`POST /modules/install`

接收模块 ZIP 并执行模块安装

如果请求体为空，后端会从 `url` 查询参数下载模块 ZIP

## Query parameters

- `url` string, uri

## Response `200`

安装输出消息列表

- WsioMessage[]
  - union
    - object
      - `type` 'stdio', required
      - `stdout` string
      - `stderr` string
    - object
      - `type` 'exit', required
      - `code` integer — 进程退出码或安装前置错误的 HTTP 状态码
      - `signal` integer

## Other responses

- `400` — 未提供请求体、请求体读取失败、下载地址无效、下载结果为空、文件无效
- `403` — 鉴权失败，或 WebSocket 票证无效
- `410` — 模块系统未安装
- `413` — 请求体或下载内容过大
- `500` — 后端执行操作失败
- `502` — JVM 交互失败、下载响应失败、远端返回非成功状态或响应内容无法解析
- `503` — JVM 服务不可用

---

[API](https://skmtc.net/oom-wg/apis/shirosu-http.md) · [All operations](https://skmtc.net/oom-wg/apis/shirosu-http/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oom-wg/shirosu-http/versions/3d63f1947f5a/schema)