DKFile API 对接文档 v1.1.2

{
  "success": true,
  "message": "文件上传成功",
  "data": {
    "file_name": "dkfile.html",
    "project_name": "我的项目",
    "file_size": 2048,
    "url": "https://dkfile.com/username/dkfile.html",
    "created_at": "2025-01-01 20:00:00",
    "updated_at": null,
    "is_update": false
  }
}

{
  "success": true,
  "message": "文件更新成功",
  "data": {
    "file_name": "dkfile.html",
    "project_name": "我的项目",
    "file_size": 3072,
    "url": "https://dkfile.com/username/dkfile.html",
    "created_at": "2025-01-01 20:00:00",
    "updated_at": "2025-01-01 21:30:00",
    "is_update": true
  }
}

{
  "success": false,
  "message": "没有上传文件",
  "error_code": "NO_FILE"
}

{
  "success": false,
  "message": "文件验证失败: HTML上传只支持HTML文件，检测到MIME类型: image/png",
  "error_code": "VALIDATION_FAILED"
}

{
  "success": false,
  "message": "您的API调用权限已被禁用，请联系管理员",
  "error_code": "API_PERMISSION_DENIED"
}

{
  "success": true,
  "data": {
    "max_file_size": 16777216,
    "max_file_size_mb": 16.0,
    "max_files_per_user": 100,
    "current_file_count": 25,
    "remaining_quota": 75,
    "allowed_extensions": [".html", ".htm"],
    "api_version": "1.0"
  }
}

# cURL示例 - 获取第2页，每页10条，搜索关键词"landing"，仅精选文件
curl -s -X GET "https://dkfile.com/dkfile_api/files?page=2&per_page=10&search=landing&is_featured=true" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

# Python示例 - 使用所有参数
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {
    'page': 2,              # 第2页
    'per_page': 10,         # 每页10条
    'search': 'landing',     # 搜索关键词
    'is_featured': 'true'    # 仅精选文件
}

resp = requests.get("https://dkfile.com/dkfile_api/files", headers=headers, params=params)
result = resp.json()

if result['success']:
    print(f"总文件数: {result['data']['total']}")
    print(f"当前页: {result['data']['page']}/{result['data']['total_pages']}")
    for file in result['data']['files']:
        print(f"- {file['project_name']} ({file['file_name']})")
else:
    print(f"错误: {result['message']}")

// JavaScript (Fetch) 示例 - 使用所有参数
const API_KEY = 'YOUR_API_KEY';
const params = new URLSearchParams({
    page: '2',
    per_page: '10',
    search: 'landing',
    is_featured: 'true'
});

fetch(`https://dkfile.com/dkfile_api/files?${params.toString()}`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`
    }
})
.then(response => response.json())
.then(data => {
    if (data.success) {
        console.log(`总文件数: ${data.data.total}`);
        console.log(`当前页: ${data.data.page}/${data.data.total_pages}`);
        data.data.files.forEach(file => {
            console.log(`- ${file.project_name} (${file.file_name})`);
        });
    } else {
        console.error('错误:', data.message);
    }
})
.catch(error => {
    console.error('请求失败:', error);
});

curl -s -X GET "https://dkfile.com/dkfile_api/files?per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'per_page': 20, 'search': 'landing'}

resp = requests.get("https://dkfile.com/dkfile_api/files", headers=headers, params=params)
print(resp.json())

curl -s -X GET "https://dkfile.com/dkfile_api/files?is_featured=true&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'is_featured': 'true', 'per_page': 20}

resp = requests.get("https://dkfile.com/dkfile_api/files", headers=headers, params=params)
print(resp.json())

{
  "success": true,
  "data": {
    "page": 1,
    "per_page": 20,
    "total": 42,
    "total_pages": 3,
    "files": [
      {
        "created_at": "2025-11-28T03:24:20.557917+00:00",
        "file_name": "fanqiezhong.html",
        "file_size": 11232,
        "is_featured": false,
        "project_name": "番茄钟",
        "updated_at": null,
        "url": "https://dkfile.net/IDOXU/fanqiezhong.html"
      },
      {
        "created_at": "2025-11-06T17:20:17.858136+00:00",
        "file_name": "24dian.html",
        "file_size": 10194,
        "is_featured": true,
        "project_name": "24dian",
        "updated_at": null,
        "url": "https://dkfile.net/IDOXU/24dian.html"
      }
    ]
  }
}

# 批量上传 dist/ 目录中的所有文件到 my-blog 项目
curl -s -X POST "https://dkfile.com/api/folders/my-blog/batch_upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files[]=@dist/index.html" \
  -F "files[]=@dist/assets/app.js" \
  -F "files[]=@dist/assets/style.css" \
  -F "overwrite_files=true" | python3 -m json.tool

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = [
    ('files[]', ('index.html', open('dist/index.html', 'rb'), 'text/html')),
    ('files[]', ('app.js', open('dist/assets/app.js', 'rb'), 'application/javascript')),
]
data = {'overwrite_files': 'true'}

resp = requests.post(
    'https://dkfile.com/api/folders/my-blog/batch_upload',
    headers=headers,
    files=files,
    data=data
)
print(resp.json())

#!/bin/sh
# .git/hooks/pre-push — Git 推送前自动构建并部署到 DKFile
echo "🚀 开始构建..."
npm run build

echo "📦 部署到 DKFile..."
curl -s -X POST "https://dkfile.com/api/folders/my-app/batch_upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files[]=@dist/index.html" \
  -F "files[]=@dist/assets/app.js" \
  -F "overwrite_files=true"

echo "✅ 部署完成！"

{
  "success": true,
  "message": "批量上传完成，成功: 5，失败: 0",
  "uploaded_count": 5,
  "failed_count": 0,
  "failed_files": []
}

{
  "success": false,
  "message": "所有文件上传失败",
  "uploaded_count": 0,
  "failed_count": 2,
  "failed_files": ["index.html"],
  "errors": [
    {
      "type": "duplicate",
      "error_code": 1312,
      "message": "文件 \"index.html\" 已存在，请设置 overwrite_files=true 覆盖",
      "file": "index.html"
    }
  ]
}

curl -s -X GET "https://dkfile.com/api/folders/my-blog/files" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

{
  "success": true,
  "files": [
    {
      "type": "file",
      "name": "index.html",
      "path": "index.html",
      "size": 2048,
      "modified": "2025-01-01T20:00:00",
      "url": "/{user_id}/my-blog/index.html"
    },
    {
      "type": "file",
      "name": "app.js",
      "path": "assets/app.js",
      "size": 10240,
      "modified": "2025-01-01T20:00:00",
      "url": "/{user_id}/my-blog/assets/app.js"
    }
  ],
  "total_files": 2,
  "folder_path": "my-blog",
  "recursive": true
}

{
  "success": false,
  "error_code": 1312,
  "error_type": "FILE_ERROR",
  "message": "文件权限错误",
  "solution": "服务器文件权限配置错误，请联系管理员",
  "details": {
    "info": "文件夹项目未激活或没有访问权限，需要先获取文件夹项目权限"
  }
}

# 读取 index.html
curl -s -X GET "https://dkfile.com/api/folders/my-blog/file/index.html" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

# 读取 assets 目录下的 JS 文件
curl -s -X GET "https://dkfile.com/api/folders/my-blog/file/assets/app.js" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

{
  "success": true,
  "name": "index.html",
  "path": "index.html",
  "content": "\n\n...\n",
  "size": 2048,
  "modified": 1735732800.0,
  "folder_path": "my-blog"
}

# 上传完成后发布
curl -s -X POST "https://dkfile.com/api/folders/my-blog/publish" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

{
  "success": true,
  "message": "发布成功！",
  "website_url": "https://dkfile.com/yourname/my-blog/",
  "is_published": true,
  "already_published": false,
  "access_control_type": "public"
}

curl -s -X POST "https://dkfile.com/dkfile_api/data/store" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"page_views","value":128,"data_type":"number","is_public":true}'

// 页面 JS 示例（公开计数器）
fetch('https://dkfile.com/dkfile_api/data/public/YOUR_USERNAME/page_views')
  .then(r => r.json())
  .then(res => console.log(res.data.value));

fetch('https://dkfile.com/api/forms/submit/my-contact', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: '张三', email: '[email protected]', message: '你好' })
}).then(r => r.json()).then(console.log);

curl -s -X POST "https://dkfile.com/api/image-host/upload" \
  -b "session=YOUR_SESSION_COOKIE" \
  -F "[email protected]"