图床V2

# 图床V2 API 接口文档 (V2) ## 接口概述 图床V2是一个将用户上传的静态图片通过中转方式理论永久存储的接口。用户上传图片后，系统自动完成中转处理，最终返回理论永久有效的图片链接。支持跨域访问，需要密钥验证。 ## 接口地址 ``` POST https://api.xunjinlu.fun/api/tc/v2.php ``` ## 请求方式 - `POST` - 使用 `multipart/form-data` 格式上传图片 ## 请求参数 ```json [ { "name": "key", "type": "string", "required": true, "description": "接口访问密钥（开启密钥访问时必填，密钥注册获取）", "example": "sk_xxxxxxxxxxxxxxxx" }, { "name": "image", "type": "file", "required": true, "description": "要上传的图片文件（仅支持静态图片）", "example": "example.jpg" } ] ``` ### 支持的图片格式（仅静态图片） | 格式 | MIME 类型 | 说明 | |------|-----------|------| | JPEG | image/jpeg | 支持 | | PNG | image/png | 支持 | | WebP | image/webp | 仅支持静态 WebP | | BMP | image/bmp | 支持 | | TIFF | image/tiff | 支持 | > ⚠️ **不支持动态图片**（GIF、动态 WebP 等），仅支持静态图片格式。 ### 限制说明 - **最大文件大小**：10MB - **输出格式**：所有上传的图片（无论原始格式）都会被统一转换为 **JPG** 格式 - **服务端会通过文件真实内容（magic bytes）识别类型**，上传的扩展名与内容不一致时将被自动修正 ## 响应参数 ### 成功响应 ```json { "code": 200, "msg": "上传成功", "data": { "url": "http://luobr.oss-cn-shanghai.aliyuncs.com/17772603123080.jpg" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 错误响应 #### 缺少密钥 ```json { "code": 401, "msg": "缺少接口访问密钥（key 参数）", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 密钥无效 ```json { "code": 403, "msg": "接口访问密钥无效", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 没有上传文件 ```json { "code": 400, "msg": "没有上传文件", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 文件过大 ```json { "code": 413, "msg": "文件大小超过限制（最大 10MB）", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 不支持的图片格式 / 动态图片 ```json { "code": 415, "msg": "不支持动态图片，仅支持静态图片格式：jpg、png、webp、bmp、tiff", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` #### 上传服务不可用 ```json { "code": 502, "msg": "上传服务暂时不可用，请稍后再试", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 响应字段说明 ### 根字段 | 字段 | 类型 | 说明 | |------|------|------| | code | int | 状态码，200为成功，其他为失败 | | msg | string | 状态描述信息 | | data | object/null | 返回的图片数据，失败时为 null | | api_info | object | API 开发者信息 | ### data 字段（成功响应） | 字段 | 类型 | 说明 | |------|------|------| | url | string | 理论永久有效的图片链接 | ### api_info 字段 | 字段 | 类型 | 说明 | |------|------|------| | developer | string | 开发者名称 | | blog | string | 开发者博客地址 | | api_platform | string | API 平台地址 | ## 错误码说明 | HTTP 状态码 | 错误码 | 描述 | |-------------|--------|------| | 200 | 200 | 上传成功 | | 400 | 400 | 没有上传文件或上传出错 | | 401 | 401 | 缺少接口访问密钥 | | 403 | 403 | 接口访问密钥无效 | | 405 | 405 | 请求方法不允许，仅支持 POST | | 413 | 413 | 文件大小超过限制 | | 415 | 415 | 不支持的图片格式或不支持动态图片 | | 502 | 502 | 上传服务或存储服务暂时不可用 | ## 技术特性 ### 图片处理 - **格式转换**：所有上传图片统一转换为 **JPG** 格式，获得更好的兼容性 - **内容检测**：服务端通过文件真实内容（magic bytes）识别类型，防止扩展名伪造 - **仅静态图片**：不支持动态图片（GIF、动态 WebP 等），确保输出格式一致性 ### 安全特性 - **密钥验证**：需要传入有效的接口访问密钥 - **CORS 支持**：已配置跨域访问，支持前端直接调用 - **文件类型校验**：通过 finfo 检测真实文件类型，防止恶意上传 ## 注意事项 1. **密钥安全**：请妥善保管接口访问密钥，不要在公开前端代码中暴露 2. **跨域支持**：接口已配置 CORS，支持跨域访问 3. **返回格式**：接口返回 UTF-8 编码的美化 JSON 数据 4. **理论永久链接**：最终返回的图片链接为理论永久有效链接 5. **请求超时**：由于涉及中转处理，建议客户端设置较长的超时时间（建议 60 秒以上） 6. **仅支持静态图片**：不支持 GIF、动态 WebP 等动态图片格式 7. **内容合规**：请勿上传违法违规内容 ## 开发者信息 - **开发者**：尋鯨錄 - **博客**：[https://www.xunjinlu.fun](https://www.xunjinlu.fun) - **API 平台**：[https://api.xunjinlu.fun](https://api.xunjinlu.fun)

# 图床V2 API 文档 ## 接口简介 图床V2 API是一个用于将用户上传的静态图片实现理论永久存储的接口。用户上传图片后，系统自动完成中转处理，最终返回永久有效的图片链接。支持跨域访问，需要密钥验证。 ## 请求说明 - **请求地址**：https://api.xunjinlu.fun/api/tc/v2.php - **请求方法**：POST - **请求头**： - `Content-Type: multipart/form-data` - `Authorization: Bearer `（如果需要密钥验证） ## 请求参数 | 参数名 | 类型 | 是否必填 | 说明 | | --- | --- | --- | --- | | 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平台链接 | ## 返回示例 ### 成功示例 ```json { "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" } } ``` ### 失败示例 ```json { "code": 400, "msg": "上传失败，请检查图片格式或大小限制" } ``` ## 错误码说明 - `400`：请求参数错误 - `401`：未授权访问 - `403`：禁止访问 - `404`：未找到接口 - `500`：服务器内部错误 ## 调用示例 ### 直接访问链接 ```plaintext https://api.xunjinlu.fun/api/tc/v2.php?key=your_api_key&image=@path/to/image.jpg ``` ### cURL命令示例 ```bash 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) 示例 ```javascript 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 示例 ```javascript $.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) 示例 ```python 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) 示例 ```php $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); ``` ### HTML (iframe/img/script标签) ```html ```