Alien Media

DEVELOPER ACCESS

API 接入文档

Alien Media API v1 · 面向当前单账号媒体中心的稳定接口约定。路径均相对于 mediadata，不允许使用 .. 或反斜杠。

当前 API Key请勿提交到公开仓库

正在读取…

BASE URLhttps://media.kjxs.top

鉴权请求头X-API-Key: <当前 Key>

响应格式application/json

1. 上传文件PUT /api/upload/{完整文件路径}

请求体是文件二进制流。路径至少包含“媒体空间/文件名”，中间目录不存在时自动创建；成功后原子发布并返回公开外链。

请求示例

正在生成包含当前 Key 的示例…

成功响应 · HTTP 201

{
  "success": true,
  "path": "demo/images/photo.jpg",
  "size": 128000,
  "publicUrl": "https://media.kjxs.top/demo/images/photo.jpg"
}

2. 文件或目录改名PATCH /api/rename

推荐的改名接口。文件、普通目录和第一层媒体空间均支持；仅改变同级名称，不承担跨目录移动。

目录改名示例

正在生成包含当前 Key 的示例…

JSON 请求体

pathstring · 必填原文件或目录的相对路径，例如 demo/旧目录

newNamestring · 必填同级新名称，只能是一个名称，不能包含 / 或 \

成功响应 · HTTP 200

{
  "success": true,
  "type": "directory",
  "oldPath": "demo/旧目录",
  "path": "demo/新目录",
  "publicUrl": null
}

3. 目录与文件管理JSON / WebDAV

读取目录 JSON

正在生成包含当前 Key 的示例…

GET/api/fs/{路径}/?json读取目录内容；返回 DUFS JSON

MKCOL/api/fs/{目录路径}/创建媒体空间或单级目录

DELETE/api/fs/{文件或目录}永久删除内容

MOVE/api/fs/{原路径}高级移动接口；目标地址放在 Destination 请求头

4. 状态码约定自定义接口返回 JSON

200改名成功

201上传成功

400JSON、路径或名称不合法

401API Key 缺失或无效

403浏览器会话 CSRF 校验失败

404改名源路径不存在

409同级目标名称已经存在

包含中文或空格的 URL 路径必须进行 UTF-8 百分号编码。改名后旧文件外链立即失效；文件响应中的 publicUrl 是新外链，目录响应固定为 null。

公开外链无需登录，格式：https://media.kjxs.top/媒体空间/任意目录/文件名