API接入文档

<img src="https://imgtoc.com/api?act=file-download&id=FILE_ID" alt="">

![photo.jpg](https://imgtoc.com/api?act=file-download&id=FILE_ID)

[img]https://imgtoc.com/api?act=file-download&id=FILE_ID[/img]

// 标准库：初始化 → 分片 → 合并
init, _ := apiJSON("POST", "/api/init", map[string]interface{}{
    "filename": filename, "size": size, "folder_id": 0,
})
taskID := init.Data["task_id"].(string)
// multipart 上传：task_id、chunk_index、chunk
uploadChunk(taskID, index, chunkData)
merged, _ := apiJSON("POST", "/api/merge", map[string]string{"task_id": taskID})
url := merged.Data["external_link"].(string)

// 服务端代理：初始化 → 分片 → 合并
$headers = ['X-API-Key: ' . $apiKey, 'Content-Type: application/json'];
$init = json_decode(file_get_contents($base . '/api/init', false, stream_context_create([
    'http' => ['method' => 'POST', 'header' => implode("\r\n", $headers),
        'content' => json_encode(['filename' => 'a.jpg', 'size' => $size])]
])), true);
// 分片 POST /api/upload/chunk（multipart: task_id, chunk_index, chunk）
// 合并 POST /api/merge {"task_id":"..."} → 使用 data.external_link

// 初始化上传
$.ajax({
    url: '/api?act=upload-init',
    method: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({
        filename: 'example.jpg',
        size: 1024000,
        hash: 'md5_hash_value'
    }),
    success: function(response) {
        if (response.success) {
            var taskId = response.data.task_id;
            // 开始上传分片
            uploadChunks(taskId, response.data.upload_urls);
        }
    }
});

// 上传分片
function uploadChunks(taskId, uploadUrls) {
    uploadUrls.forEach(function(item, index) {
        // 使用预签名URL直接上传到云存储
        $.ajax({
            url: item.upload_url,
            method: 'PUT',
            contentType: 'application/octet-stream',
            data: chunkData,
            success: function() {
                // 分片上传成功
            }
        });
    });
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "mime/multipart"
    "net/http"
    "os"
)

const baseURL = "https://imgtoc.com"
const apiKey = "YOUR_API_KEY" // 仅从服务端环境变量读取

func main() {
    data, _ := os.ReadFile("example.jpg")
    // 1) 初始化
    initBody, _ := json.Marshal(map[string]interface{}{
        "filename": "example.jpg", "size": len(data), "folder_id": 0,
    })
    req, _ := http.NewRequest("POST", baseURL+"/api/init", bytes.NewReader(initBody))
    req.Header.Set("X-API-Key", apiKey)
    req.Header.Set("Content-Type", "application/json")
    resp, _ := http.DefaultClient.Do(req)
    var init struct {
        Success bool `json:"success"`
        Data    struct {
            TaskID        string `json:"task_id"`
            ChunkSize     int    `json:"chunk_size"`
            InstantUpload bool   `json:"instant_upload"`
            ExternalLink  string `json:"external_link"`
        } `json:"data"`
    }
    json.NewDecoder(resp.Body).Decode(&init)
    resp.Body.Close()
    if init.Data.InstantUpload {
        fmt.Println(init.Data.ExternalLink)
        return
    }
    // 2) 分片上传（字段名必须为 chunk）
    taskID := init.Data.TaskID
    chunkSize := init.Data.ChunkSize
    if chunkSize <= 0 { chunkSize = len(data) }
    for i, off := 0, 0; off < len(data); i, off = i+1, off+chunkSize {
        end := off + chunkSize
        if end > len(data) { end = len(data) }
        var buf bytes.Buffer
        w := multipart.NewWriter(&buf)
        w.WriteField("task_id", taskID)
        w.WriteField("chunk_index", fmt.Sprintf("%d", i))
        part, _ := w.CreateFormFile("chunk", "chunk")
        part.Write(data[off:end])
        w.Close()
        cr, _ := http.NewRequest("POST", baseURL+"/api/upload/chunk", &buf)
        cr.Header.Set("X-API-Key", apiKey)
        cr.Header.Set("Content-Type", w.FormDataContentType())
        http.DefaultClient.Do(cr)
    }
    // 3) 合并，取外链
    mergeBody, _ := json.Marshal(map[string]string{"task_id": taskID})
    mr, _ := http.NewRequest("POST", baseURL+"/api/merge", bytes.NewReader(mergeBody))
    mr.Header.Set("X-API-Key", apiKey)
    mr.Header.Set("Content-Type", "application/json")
    mresp, _ := http.DefaultClient.Do(mr)
    var merged struct {
        Data struct{ ExternalLink string `json:"external_link"` } `json:"data"`
    }
    json.NewDecoder(mresp.Body).Decode(&merged)
    fmt.Println(merged.Data.ExternalLink)
}

import requests

# 初始化上传
response = requests.post(
    'http://your-domain.com/api?act=upload-init',
    json={
        'filename': 'example.jpg',
        'size': 1024000,
        'hash': 'md5_hash_value'
    },
    cookies={'session': 'your_session_cookie'}
)

if response.json()['success']:
    task_data = response.json()['data']
    task_id = task_data['task_id']
    
    # 上传分片
    for chunk_info in task_data['upload_urls']:
        chunk_index = chunk_info['chunk_index']
        upload_url = chunk_info['upload_url']
        
        # 读取分片数据
        with open(f'chunk_{chunk_index}', 'rb') as f:
            chunk_data = f.read()
        
        # 上传到云存储
        requests.put(upload_url, data=chunk_data)