图床v1(推荐用V2)

# 图床上传API详细文档 ## API基础介绍 ### 概述 图床上传API是一个专业的图片上传服务接口，提供快速、稳定的图片上传功能。该接口接收用户上传的图片文件，将图片转发到Telegram图床服务进行存储，并返回可直接访问的图片URL。支持JPG、PNG、GIF、WEBP等常见图片格式，单张图片最大支持10MB。 ### 版本信息 | 属性 | 值 | | --- | --- | | 当前版本 | v1.0.0 | | 发布日期 | 2026-04-08 | | 兼容性 | PHP 7.4 / 8.0 / 8.2 | | 开发者 | 尋鯨錄 | *** ## API描述 ### 功能描述 本API提供以下核心功能： 1. **图片上传**：接收multipart/form-data格式的图片文件，支持JPG、PNG、GIF、WEBP格式，单张图片最大支持10MB 2. **图片存储**：图片存储在Telegram服务器，返回可直接访问的图片URL，图片永久有效 3. **文件验证**：文件类型双重验证（扩展名+MIME类型）、文件大小限制检查、上传错误详细诊断 4. **响应处理**：标准化JSON响应格式、处理耗时统计、完整的错误信息返回 ### 应用场景 - 博客文章图片上传 - 用户头像上传 - 论坛帖子图片上传 - 各类需要图片存储的应用 ### 核心特性 | 特性 | 说明 | | --- | --- | | 多格式支持 | JPG/JPEG、PNG、GIF、WEBP | | 安全验证 | 文件扩展名验证、MIME类型验证、文件大小限制 | | 高性能 | 响应时间 < 2秒、异步统计、流式上传 | *** ## 接口信息 | 属性 | 值 | | --- | --- | | 接口地址 | https://api.xunjinlu.fun/tc/index.php | | 请求方式 | POST | | 请求格式 | multipart/form-data | | 响应格式 | application/json | | 字符编码 | UTF-8 | | 版本 | 1.0.0 | *** ## 请求参数说明 ### 参数列表 | 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 | | --- | --- | --- | --- | --- | --- | | image | file | 是 | null | 要上传的图片文件，支持JPG/PNG/GIF/WEBP格式 | image.jpg | ### 参数详细说明 #### image（图片文件参数） | 属性 | 值 | | --- | --- | | 类型 | file（文件） | | 必填 | 是 | | 用途 | 指定要上传的图片文件 | **支持的格式**： | 格式类型 | MIME类型 | 扩展名 | 说明 | | --- | --- | --- | --- | | JPEG | image/jpeg | .jpg, .jpeg | 常见的图片格式，适合照片 | | PNG | image/png | .png | 支持透明背景，适合图标、截图 | | GIF | image/gif | .gif | 支持动画，适合表情包 | | WEBP | image/webp | .webp | 新一代图片格式，体积小质量高 | **文件限制**： | 限制项 | 值 | 说明 | | --- | --- | --- | | 最大文件大小 | 10MB | 10 * 1024 * 1024 = 10485760 字节 | | 最小文件大小 | 无限制 | 但不能为空文件 | *** ## 返回参数说明 ### 成功响应结构 | 字段名 | 类型 | 说明 | 示例值 | | --- | --- | --- | --- | | code | int | 状态码，200表示成功 | 200 | | msg | string | 状态描述 | success | | url | string | 上传成功后的图片访问地址 | https://521.im/NGi9Qq4S.jpeg | | time | string | 接口处理耗时 | 0.3s | | success | bool | 操作是否成功 | true | | api_info | object | API信息对象 | - | ### api_info 对象字段 | 字段名 | 类型 | 说明 | 示例值 | | --- | --- | --- | --- | | developer | string | 开发者 | 尋鯨錄 | | blog | string | 开发者博客 | https://www.xunjinlu.fun | | api_platform | string | API平台地址 | https://api.xunjinlu.fun | *** ## 错误返回说明 ### 错误码说明 | 错误码 | 说明 | 解决方案 | | --- | --- | --- | | 200 | 上传成功 | - | | 400 | 参数错误或文件不符合要求 | 检查文件格式和大小 | | 405 | 请求方法不允许 | 使用POST请求 | | 429 | 请求频率过高 | 降低请求频率 | | 500 | 服务器内部错误 | 稍后重试 | ### 错误响应示例 #### 缺少image参数 | 字段 | 值 | | --- | --- | | code | 400 | | msg | 缺少image参数 | | success | false | #### 文件类型不支持 | 字段 | 值 | | --- | --- | | code | 400 | | msg | 只支持 JPG, PNG, GIF, WEBP 格式的图片 | | success | false | #### 文件过大 | 字段 | 值 | | --- | --- | | code | 400 | | msg | 图片大小不能超过10MB | | success | false | #### 请求方法不允许 | 字段 | 值 | | --- | --- | | code | 405 | | msg | 请求方法不允许，请使用POST请求 | | success | false | #### 请求频率过高 | 字段 | 值 | | --- | --- | | code | 429 | | msg | 请求太快了~ | | success | false | ### 上传错误码说明（PHP内部错误码） | 错误码 | 常量名 | 说明 | | --- | --- | --- | | 0 | UPLOAD_ERR_OK | 上传成功 | | 1 | UPLOAD_ERR_INI_SIZE | 文件大小超过服务器限制 | | 2 | UPLOAD_ERR_FORM_SIZE | 文件大小超过表单限制 | | 3 | UPLOAD_ERR_PARTIAL | 文件只有部分被上传 | | 4 | UPLOAD_ERR_NO_FILE | 没有文件被上传 | | 6 | UPLOAD_ERR_NO_TMP_DIR | 缺少临时文件夹 | | 7 | UPLOAD_ERR_CANT_WRITE | 文件写入失败 | | 8 | UPLOAD_ERR_EXTENSION | 文件上传被扩展阻止 | ***

> **由 AI 生成**：以下文档内容根据提供的信息自动生成，仅供参考，具体实现以实际接口为准。 ## 接口简介 图床v1接口用于接收图片文件上传，将图片转发到Telegram图床服务，并返回图片访问URL。适用于需要快速上传图片并获取URL的场景，无需鉴权。 ## 请求说明 - URL：https://api.xunjinlu.fun/api/tc/index.php - 方法：POST - 请求头：Accept: application/json ## 请求参数表 | 名称 | 类型 | 必填 | 说明 | | ---- | ---- | ---- | ---- | | image | file | 是 | 要上传的图片文件，支持 JPG/PNG/GIF/WEBP 格式 | ## 返回字段表 | 字段名 | 类型 | 说明 | | ---- | ---- | ---- | | code | number | 状态码，200表示成功 | | msg | string | 状态信息 | | url | string | 图片访问URL | | time | string | 上传耗时 | | success | boolean | 是否成功 | | api_info | object | API信息 | ## 返回 JSON 示例 **成功示例**： ```json { "code": 200, "msg": "success", "url": "https://521.im/NGi9Qq4S.jpeg", "time": "0.3s", "success": true, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` **失败示例**： ```json { "code": 400, "msg": "Invalid image format", "url": "", "time": "0.1s", "success": false, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 错误与状态 - 200: 成功 - 400: 无效的请求参数 - 500: 服务器内部错误 ## 调用示例 **直接访问**： ``` https://api.xunjinlu.fun/api/tc/index.php ``` **cURL**： ```bash curl -X POST "https://api.xunjinlu.fun/api/tc/index.php" -H "Content-Type: multipart/form-data" -F "image=@/path/to/image.jpg" ``` **Python requests**： ```python import requests url = "https://api.xunjinlu.fun/api/tc/index.php" files = {'image': open('/path/to/image.jpg', 'rb')} response = requests.post(url, files=files) print(response.json()) ``` **PHP**： ```php '@/path/to/image.jpg']); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); print(json_decode($response, true)); ?> ``` **HTML**： ```html ```