图片托管系统 API 文档

基础信息

基础 URL: https://pic.tencent155.cn/api/

所有 API 请求都需要使用 HTTPS 协议。

认证说明

所有 API 请求都需要在请求头中添加认证信息。使用 Bearer Token 认证方式，Token 需要在用户中心获取。

Authorization: Bearer YOUR_API_TOKEN

注意：API Token 是敏感信息，请妥善保管，不要泄露给他人。

错误码说明

状态码 说明
200 请求成功
400 请求参数错误（如：缺少必要参数、参数格式错误、图片大小超过限制等）
401 未授权（如：未提供 Token、Token 无效等）
403 禁止访问（如：没有权限执行该操作）
404 资源不存在（如：请求的图片不存在）
500 服务器内部错误（如：数据库错误、文件系统错误等）

API 端点列表

名称 方法 URL 描述
上传图片 POST /api/upload.php 上传图片文件到服务器
获取图片 GET /api/get_image.php 获取指定ID的图片信息
删除图片 POST /api/delete_image.php 删除指定ID的图片（需要登录，只能删除自己的图片或管理员可删除任意图片）
批量删除图片 POST /api/batch_delete_images.php 批量删除多张图片（需要登录，只能删除自己的图片或管理员可删除任意图片）

上传图片

URL: /api/upload.php

方法: POST

描述: 上传图片文件到服务器

参数说明

参数名说明
imagefile - 图片文件（必须）

响应示例

{
    "status": "string, 状态（success\/error）",
    "url": "string, 图片访问URL",
    "id": "int, 图片ID",
    "debug": {
        "original_path": "string, 原始文件路径（仅供调试）"
    }
}

使用方法例子

curl -X POST "https://pic.tencent155.cn/api/upload.php" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "image=@/path/to/your/file"

获取图片

URL: /api/get_image.php

方法: GET

描述: 获取指定ID的图片信息

参数说明

参数名说明
idint - 图片ID（必须）

响应示例

{
    "status": "string, 状态（success\/error）",
    "url": "string, 图片访问URL",
    "debug": {
        "original_path": "string, 原始文件路径（仅供调试）"
    }
}

使用方法例子

curl -X GET "https://pic.tencent155.cn/api/get_image.php?id=your_id" \
-H "Authorization: Bearer YOUR_API_TOKEN"

删除图片

URL: /api/delete_image.php

方法: POST

描述: 删除指定ID的图片（需要登录，只能删除自己的图片或管理员可删除任意图片）

参数说明

参数名说明
imageIdint - 图片ID（必须）

响应示例

{
    "success": "boolean, 操作是否成功",
    "message": "string, 操作结果消息"
}

使用方法例子

curl -X POST "https://pic.tencent155.cn/api/delete_image.php" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d 'imageId=your_imageId'

批量删除图片

URL: /api/batch_delete_images.php

方法: POST

描述: 批量删除多张图片（需要登录，只能删除自己的图片或管理员可删除任意图片）

参数说明

参数名说明
imageIdsarray - 图片ID数组（必须）

响应示例

{
    "success": "boolean, 操作是否成功",
    "message": "string, 操作结果消息，包含成功和失败的数量"
}

使用方法例子

curl -X POST "https://pic.tencent155.cn/api/batch_delete_images.php" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d 'imageIds=[1,2,3]'