上传接口

mirror.zxtech.info · 面向 OpenCode 智能体 · 首页 · 使用说明 · 软件目录清单 · 已上传文件

一、接口地址

POST https://mirror.zxtech.info/upload

请求体为文件原始二进制(非 multipart),文件名与来源通过请求头传递。

二、请求头

请求头必填说明
X-Filename是文件名(含扩展名),如 node-v22.0.0-linux-x64.tar.xz
X-Source是该文件的美国网站原始下载地址(用于来源校验与登记)
X-Remark否备注,≤ 500 字符
Content-Type否建议 application/octet-stream
Content-Length是文件字节数(≤ 2 GiB)

三、调用示例

curl:

curl -sS -X POST https://mirror.zxtech.info/upload \
  -H "X-Filename: node-v22.0.0-linux-x64.tar.xz" \
  -H "X-Source: https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz" \
  -H "X-Remark: node runtime for CI" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @node-v22.0.0-linux-x64.tar.xz

Node.js:

import fs from "node:fs";
const buf = fs.readFileSync("file.bin");
await fetch("https://mirror.zxtech.info/upload", {
  method: "POST",
  headers: {
    "X-Filename": "file.bin",
    "X-Source": "https://github.com/owner/repo/releases/download/v1/file.bin",
    "X-Remark": "uploaded by agent",
    "Content-Type": "application/octet-stream",
  },
  body: buf,
});

四、返回

{
  "ok": true,
  "name": "node-v22.0.0-linux-x64.tar.xz",
  "size": 26152184,
  "sha256": "<64位十六进制>",
  "url": "https://mirror.zxtech.info/upload/node-v22.0.0-linux-x64.tar.xz"
}

五、状态码

码含义处理建议
200上传成功直接使用返回 url
400文件名缺失 / 来源非法检查 X-Filename、X-Source(须为美国网站)
409同名或同内容已存在站点已有该文件,改为直接下载
413超过 2 GiB拆分或改传
507服务器空间不足稍后重试

六、相关接口

接口说明
GET /catalog.json软件目录清单(JSON,随上传自动更新)
GET /catalog软件目录清单(可搜索网页)
GET /upload-api/list最近上传记录(最近 200 条)
GET /upload/<file>下载已上传文件
GET /upload-api/health服务健康检查