企业级文件存储
安全 · 高效 · 可信

# 直接访问文件（返回原始文件流）
$ curl "https://c88y.com/admin.php?id=46&file=1750394282_266911bd.png"

# 访问成功：返回文件原始字节流，供直接展示或下载

 若请求来自未授权域名，将返回 HTTP 200 + JSON：{"status":"error","message":"该域名未被授权访问"}，并计入未授权访问统计。

# 使用 API 密钥删除文件
$ curl -X POST "https://c88y.com/delete_image.php" \
    -F "id=46" \
    -F "key=你的API密钥" \
    -F "filename=1750394282_266911bd.png"

# 成功响应
{
  "status": "success",
  "message": "删除成功",
  "filename": "1750394282_266911bd.png"
}

# 未提供 id / key，或密钥无效
{ "status": "error", "message": "无效的API密钥" }

 也支持以 JSON 方式提交（Content-Type: application/json，字段名相同）；filename 还可直接粘贴整条访问 URL，服务端会自动解析其中的 file= 参数。文件不存在或不属于该用户时返回 404。

# 未开启下载鉴权（默认）：无需 key
$ curl "https://c88y.com/admin.php?id=46&file=1750394282_266911bd.png"

# 开启下载鉴权后：必须携带 key
$ curl "https://c88y.com/admin.php?id=46&file=1750394282_266911bd.png&key=你的API密钥"

# 密钥无效时返回
{ "status": "error", "message": "无效的API密钥" }

 密钥建议每 90 天重置一次；重置后旧密钥立即失效。请勿将密钥暴露在浏览器或客户端代码中。

# 在「自定义文件名」面板开启后：
$ curl -X POST "https://c88y.com/admin.php" \
    -F "image=@./logo.png" \
    -F "id=46" \
    -F "key=你的API密钥" \
    -F "file_name=my-logo.png"

# 扩展名不一致时返回 400
{
  "status": "error",
  "message": "文件扩展名不匹配",
  "detail": "自定义文件名的扩展名必须与上传文件的扩展名一致"
}

 同一专属目录内文件名不可重复，重复上传将返回 400 文件名重复。真实响应以线上实际返回为准。

# 容量已达 100%，上传被拒绝
{
  "status": "error",
  "code": "QUOTA_EXCEEDED",
  "message": "存储空间不足，上传已被拒绝",
  "detail": "已使用 80 GB / 80 GB，请先删除文件或申请提升容量",
  "quota": { "total": 85899345920, "used": 85899345920, "free": 0, "percent": 100 }
}

# 非图片类型且尚未通过审批
{
  "status": "error",
  "code": "TYPE_NOT_ALLOWED",
  "message": "文件类型未授权",
  "detail": "图片类型可直接上传；.pdf 需要先在「类型申请」中提交申请并通过审批"
}

 建议客户端判断 code 字段：容量类错误提示用户清理文件或申请扩容，类型类错误引导用户提交类型申请。