开放 API 文档

面向需要在自有网站、图床脚本、客户端程序里调用本云盘上传 / 管理文件的开发者

一、概述

二、图床式上传（核心接口）

POSTapi_upload — 单文件直传，返回直链

用于图床 / 文件服务器场景：一个请求上传一张图（或任意文件），直接拿到可公开访问的 URL。

POST http://pan.6665q.com/api.php?action=api_upload
Authorization: Bearer <Token>
Content-Type: multipart/form-data

file      = 文件二进制（multipart 表单，必填）
folder_id = 目标文件夹 ID（可选，默认 0 根目录）

成功返回

{
  "code": 0,
  "msg": "上传成功",
  "data": {
    "file_id": 13,
    "name": "图片.png",
    "size": 92160,
    "md5": "ab8717f458d557f82ad26e6a9fa3cd7a",
    "instant": false,
    "url": "http://pan.6665q.com/uploads/202609/njawg08xPrhxFSFK.png"
  }
}

• url 即文件直链，可直接用于 <img src>、下载链接等。
• instant = true 表示命中秒传（同 MD5 文件已存在，直接复用，不重复占用空间）。

失败返回

{ "code": 401, "msg": "未登录", "data": null }
{ "code": 400, "msg": "缺少文件（字段名 file）", "data": null }
{ "code": 403, "msg": "空间不足：已用 1.2 MB，剩余 0 B", "data": null }

三、缩略图与图片处理

上传图片时系统会自动生成缩略图（JPEG），返回中的 thumb 即缩略图地址，可直接用于列表预览、图床引用。

GETthumb.php — 动态缩略图

GET http://pan.6665q.com/thumb.php?id={file_id}              默认缩略图（长边 300）
GET http://pan.6665q.com/thumb.php?id={file_id}&w=200        指定宽（高按比例）
GET http://pan.6665q.com/thumb.php?id={file_id}&w=200&h=200  指定宽高（等比不裁剪）
GET http://pan.6665q.com/thumb.php?id={file_id}&webp=1       输出 WebP（体积更小）
GET http://pan.6665q.com/thumb.php?id={file_id}&q=90         质量 1-100

返回图片二进制（非 JSON），浏览器缓存 7 天。图片处理基于服务器 GD 库，支持 JPEG / PNG / GIF / WebP / BMP 输入。

四、Token 管理

五、文件管理接口

以下接口均需登录态（会话或 Bearer Token）。

files_list 返回示例

{
  "code": 0,
  "data": {
    "total": 12,
    "page": 1,
    "list": [
      {
        "id": 13, "name": "图片.png", "folder_id": 0, "is_dir": false,
        "size": 92160, "size_text": "90 KB", "ext": "png", "kind": "image",
        "created_at": "2026-09-22 10:00:00", "time_ago": "3 小时前"
      }
    ]
  }
}

六、分享接口

share_create 返回

{
  "code": 0,
  "data": {
    "share": {
      "token": "AbCdEf123456",
      "code": "",
      "url": "http://pan.6665q.com/s/AbCdEf123456",
      "download_url": "http://pan.6665q.com/download.php?token=AbCdEf123456"
    }
  }
}

七、预览接口

八、多语言调用示例（图床上传）

cURL

curl -X POST "http://pan.6665q.com/api.php?action=api_upload" \
  -H "Authorization: Bearer 你的Token" \
  -F "file=@/path/to/image.png"

PHP

<?php
$token = '你的Token';
$ch = curl_init('http://pan.6665q.com/api.php?action=api_upload');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("/path/to/img.png")],
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $res["code"] === 0 ? $res["data"]["url"] : $res["msg"];

Python

import requests

token = "你的Token"
url = "http://pan.6665q.com/api.php?action=api_upload"
headers = {"Authorization": f"Bearer {token}"}

with open("image.png", "rb") as f:
    r = requests.post(url, headers=headers, files={"file": f})

res = r.json()
print(res["data"]["url"] if res["code"] == 0 else res["msg"])

JavaScript（浏览器 fetch）

const token = '你的Token';
const form = new FormData();
form.append('file', fileInput.files[0]);

fetch('http://pan.6665q.com/api.php?action=api_upload', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer ' + token },
    body: form,
})
.then(r => r.json())
.then(res => {
    if (res.code === 0) console.log(res.data.url);
    else console.error(res.msg);
});

HTML 表单（最简单，适合临时测试）

<form action="http://pan.6665q.com/api.php?action=api_upload&token=你的Token"
      method="post" enctype="multipart/form-data">
    <input type="file" name="file">
    <button type="submit">上传</button>
</form>

九、常见问题

十、授权开放接口（网站 / 插件）

面向「你的客户网站/插件」的授权校验接口。客户站点不登录本站，通过 授权码 + 域名 校验。所有响应带 HMAC-SHA256 签名（后台授权管理生成密钥后启用）。

1. 在线校验

2. 激活 / 换绑 / 吊销

十一、授权接口在线测试台

等待请求…