图床V2 API 文档

接口简介

图床V2 API是一个用于将用户上传的静态图片实现理论永久存储的接口。用户上传图片后，系统自动完成中转处理，最终返回永久有效的图片链接。支持跨域访问，需要密钥验证。

请求说明

请求地址：https://api.xunjinlu.fun/api/tc/v2.php
请求方法：POST
请求头：

- Content-Type: multipart/form-data - Authorization: Bearer <your_api_key>（如果需要密钥验证）

请求参数

参数名	类型	是否必填	说明
key	string	是	接口访问密钥（开启密钥访问时必填）
image	file	是	要上传的图片文件（仅支持静态图片）

返回参数

参数名	类型	说明
code	integer	状态码，200表示成功
msg	string	状态信息
data	object	返回数据
data.url	string	图片链接
api_info	object	API信息
api_info.developer	string	开发者信息
api_info.blog	string	开发者博客链接
api_info.api_platform	string	API平台链接

返回示例

成功示例

{
    "code": 200,
    "msg": "上传成功",
    "data": {
        "url": "http://luobr.oss-cn-shanghai.aliyuncs.com/17784975435810.jpg"
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

失败示例

{
    "code": 400,
    "msg": "上传失败，请检查图片格式或大小限制"
}

错误码说明

400：请求参数错误
401：未授权访问
403：禁止访问
404：未找到接口
500：服务器内部错误

调用示例

直接访问链接

https://api.xunjinlu.fun/api/tc/v2.php?key=your_api_key&image=@path/to/image.jpg

cURL命令示例

curl -X POST "https://api.xunjinlu.fun/api/tc/v2.php" -H "Content-Type: multipart/form-data" -F "key=your_api_key" -F "image=@path/to/image.jpg"

JavaScript (fetch) 示例

fetch('https://api.xunjinlu.fun/api/tc/v2.php', {
    method: 'POST',
    body: new FormData(),
    body.append('key', 'your_api_key');
    body.append('image', new File([path/to/image.jpg], 'image.jpg'));
});

jQuery AJAX 示例

$.ajax({
    url: 'https://api.xunjinlu.fun/api/tc/v2.php',
    type: 'POST',
    data: {
        key: 'your_api_key',
        image: '@path/to/image.jpg'
    },
    contentType: false,
    processData: false,
    success: function(response) {
        console.log(response);
    },
    error: function(xhr, status, error) {
        console.error(error);
    }
});

Python (requests) 示例

import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

data = MultipartEncoder(

    fields={

        'key': 'your_api_key',

        'image': ('image.jpg', open('path/to/image.jpg', 'rb'))

    }

)

response = requests.post('https://api.xunjinlu.fun/api/tc/v2.php', data=data)

print(response.json())

PHP (curl) 示例

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.xunjinlu.fun/api/tc/v2.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'your_api_key',
    'image' => '@path/to/image.jpg'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
print($response);

图床V2

图床V2 API 文档

接口简介

请求说明

请求参数

返回参数

返回示例

成功示例

失败示例

错误码说明

调用示例

直接访问链接

cURL命令示例

JavaScript (fetch) 示例

jQuery AJAX 示例

Python (requests) 示例

PHP (curl) 示例

HTML (iframe/img/script标签)