FAQ
API 接口升级说明
从 EasyYun 接口升级变化
- 请求的域名从
https://rest-api.easyyun.com/v1/router/rest
调整为https://pdf-api.pdfai.cn/v1/pdf/
+每个功能缀 - 每个功能的接口是单独 URL,接口与接口之间没有任何关联
- 系统请求头
application/x-www-form-urlencoded
调整为application/json
,返回结果格式还是 JSON,具体可以看代码例子 - 返回结果 code 值类型为调整为
int
- 补充每个功能的开发语言的代码例子,降低门槛
- 历史的接口部分功能有兼容,比如
https://pdf-api.pdfai.cn/v1/router/rest
,此域名接口依然有效,待过渡期后,此路由会下线 - 没有测试环境,正式环境所见即所得
文件删除时间
上传的文件默认 1 天自动删除,本工具仅做转换服务,不做存储服务,文件请自行下载保存。如果需要单独存储,可私有化部署,单独配置阿里云OSS和腾讯云COS。
是否收费
云端API免费,不提供任何承诺稳定性保障。建议使用私有化部署。
市面上已经有非常成熟的开源产品,比如:Stirling-PDF、PdfCpu、MuPDF,大家可以尝试。
关于技术选型
2022.3-2025.2 差不多 3 年的时间采用所谓时髦的技术:Docker、Kubernetes、Golang、Python、Vue、Electron 、MySQL、Redis、Nginx 等。
然而,时髦的技术并为解决问题,只会让技术问题变得更复杂。
SO,这次的重新设计,为了简化问题。
只为做减法
- 开发流程上每个功能就只有 1 个接口
- 去掉异步的功能,现实中,大部分也用不上
- 去掉 MySQL,去掉 Redis,的确也用不上,加上数据库只会让项目更复杂
- 去掉 Docker,去掉 Kubernetes,完全没必要
- 去掉 Electron,虽然使用 tauri.app 也简单,为了体验,去掉了电脑客户端
- 服务器去掉依赖的一些命令行,比如 pdfcpu、mutools 等。
- 接口文档,为了简化,采用了 VuePress
- 去掉了Office类的接口,这个必须使用付费厂商的才有产品体验,比如金山文档、腾讯文档等