API 文档
本页面提供粘贴图片即时下载工具的API接口文档,适用于开发Chrome插件或其他第三方应用。
基础 URL:https://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]