---
title: "插件 API 转发 catch-all（动态路由）"
method: GET
path: "/jsplugin/{entryPath}/{path}"
tags: ["JS 插件"]
---

# 插件 API 转发 catch-all（动态路由）

`GET /jsplugin/{entryPath}/{path}`

接受任意 HTTP 方法，分发到插件 static 兜底、入站 WebSocket upgrade（调用 onWebSocket），或转发到 QuickJS 沙盒中的插件代码。{entryPath} 和子路径均由运行时决定，OpenAPI 仅作占位。需要 BearerAuth。

## Path parameters

- `entryPath` string, required

## Headers

- `X-Plugin-Timeout-Ms` integer

## Response `200`

插件自定义响应

- object

## Other responses

- `403` — 插件未启用
- `404` — 插件不存在
- `503` — 插件不可用或运行异常（健康检查会自愈）
- `504` — JS 运行时调用超时

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/77467de6ed1b/schema)