图床API文档

接口简介

图床API是一个多接口自适应图床服务，支持将图片文件上传到分布式图床服务并获取永久外链URL。系统会根据文件大小自动选择最优上传接口，适用于网站图片托管、图床服务集成、CDN加速等场景。

请求说明

完整请求地址：https://api.xunjinlu.fun/tc/api.php
请求方法：POST
请求头说明：

- Content-Type: multipart/form-data (用于上传文件)

请求参数

参数名	类型	是否必填	说明
---	---	---	---
file	file	是	要上传的图片文件，支持JPG、PNG、GIF等格式，最大20MB

返回参数

参数名	类型	说明
---	---	---
code	number	状态码，200表示成功
data	object	返回数据
data.success	boolean	是否上传成功
data.url	string	图片外链URL
data.totalUploads	number	总上传次数
data.apiCallCount	number	API调用次数
message	string	返回信息

返回示例

{
  "code": 200,
  "data": {
    "success": true,
    "url": "https://example.com/image.jpg",
    "totalUploads": 123,
    "apiCallCount": 456
  },
  "message": "success"
}

错误码说明

错误码	含义
---	---
400	请求参数错误
401	未授权访问
403	禁止访问
500	服务器错误

调用示例

直接访问链接

https://api.xunjinlu.fun/tc/api.php

cURL命令示例

curl -F "file=@/path/to/image.jpg" https://api.xunjinlu.fun/tc/api.php

JavaScript (fetch) 示例

fetch('https://api.xunjinlu.fun/tc/api.php', {
  method: 'POST',
  body: new FormData()
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

jQuery AJAX 示例

$.ajax({
  url: 'https://api.xunjinlu.fun/tc/api.php',
  type: 'POST',
  data: new FormData(),
  processData: false,
  contentType: false,
  success: function(data) {
    console.log(data);
  },
  error: function(error) {
    console.error('Error:', error);
  }
});

Python (requests) 示例

import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

data = MultipartEncoder(fields={'file': ('image.jpg', open('image.jpg', 'rb'))})

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

print(response.json())

PHP (curl) 示例

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

HTML (iframe/img/script标签)

<!-- iframe方式 -->
<iframe src="https://api.xunjinlu.fun/tc/api.php" style="display:none;"></iframe>

<!-- img方式 -->

<img src="https://api.xunjinlu.fun/tc/api.php" style="display:none;"/>

<!-- script方式 -->

<script>

fetch('https://api.xunjinlu.fun/tc/api.php')

  .then(response => response.json())

  .then(data => console.log(data))

  .catch(error => console.error('Error:', error));

</script>