API 文档

本页面提供粘贴图片即时下载工具的API接口文档,适用于开发Chrome插件或其他第三方应用。

基础 URLhttps://paste-to-download.com

概览

本 API 适用于计划开发的 Chrome 插件或其他第三方前端应用,用于将粘贴图片或拖拽图片的功能在插件中实现后,通过 API 提交图片元数据,以便网站进行统计、日志记录或后续处理。

1. POST /api/image-log

功能:记录用户在插件中粘贴或拖拽的图片操作(仅记录 metadata,不上传图片文件)。
请求方法:POST
请求体类型application/json

请求参数

字段 类型 必填 描述
clientId string 插件生成的用户唯一 ID(如 UUID)
source string 图片来源:clipboard、drag 或 url
fileName string 用户操作的图片文件名
size number 图片大小,单位字节
format string 图片格式,例如 jpg / png / webp
timestamp integer 操作时间戳(毫秒)

请求示例

{
  "clientId": "b834-ffe2-8899",
  "source": "clipboard",
  "fileName": "screenshot.png",
  "size": 153248,
  "format": "png",
  "timestamp": 1715071220000
}

响应示例

{
  "success": true,
  "message": "日志记录成功"
}

状态码说明

状态码 描述
200 成功
400 参数缺失或格式错误
500 服务器错误

API 安全建议

  • 验证字段完整性,防止伪造或恶意滥用
  • 如部署上线前需启用 Token 验证或 Referer 检查

开发与集成

如果您计划开发基于我们API的应用或插件,欢迎参考我们的GitHub仓库,或通过联系我们页面与我们取得联系。

我们会持续更新和完善API文档。如有任何疑问或建议,请联系我们:[email protected]