1.玩转云服务(9):使用 Cloudflare Workers + D1 + R2 搭建免费的文档文档随机 API
2.API接口文档管理利器-swagger
3.Stirling PDF:开源在线PDF文档编辑工具库源码
玩转云服务(9):使用 Cloudflare Workers + D1 + R2 搭建免费的随机 API
上次介绍了如何自建随机 API,但存在一些限制。转图转图转今天,片a片我将介绍如何使用 Cloudflare 工具链来搭建一个更完善的源码源码免费随机 API。
这套方案具有以下优点:无需购买域名,文档文档利用 Cloudflare 的转图转图转积分源码奶粉免费额度即可满足需求。
以下是片a片每个服务的免费额度:R2: GB存储,每月万次A类请求,源码源码万次B类请求。文档文档Workers:每天万次请求。转图转图转D1:每天万行读,片a片万行写,源码源码1 GB存储。文档文档k线指标源码Cloudflare KV:每天万次读请求,转图转图转1千次写,片a片1千次删除,1千次列出和1GB存储。
配置R2对象存储时,需要将CORS配置为允许所有源,以便Sakurairo预载封面图。根据图集数量创建相应数量的R2桶,并将上传到对应的桶中。
在网页端建立数据库,用来存放信息和在R2上的URL。使用在线工具生成SQL,公开课 源码然后将SQL粘贴到D1数据库中执行。
配置Workers API时,可以创建Pro版本或普通版本。Pro版本可以使用SQL进行更强大的查询,普通版本使用rpic.js中的代码。
如何使用API和查看文档网站,请参考API文档网站。
源码地址:github.com/Eterance/doc...
如何部署自己的文档网站,请参考相关教程。
API接口文档管理利器-swagger
在现代开发模式中,前后端分离促使团队成员分工明确,但随之而来的源码测试工具是API接口沟通的挑战。过去,通过Word文档传递接口信息效率低下且难以实时更新。后来,我尝试了阿里妈妈团队开发的rap2 API管理平台,它提供了文档管理、Mock和导出等功能,极大地提升了沟通效率,但维护接口文档与代码的一致性问题也随之而来,特别是在项目迭代频繁时。
为了解决这些问题,我们引入了API接口文档管理利器Swagger。Swagger以SpringBoot项目为例,小工具源码通过添加依赖和配置类,如@Api、@ApiOperation等注解,开发者可以直接在代码中编写和维护接口文档,无需额外维护一个独立文档。本地启动项目后,Swagger会自动生成易于阅读和调试的接口文档,如Date类型字段的展示可以根据需求定制。
对于更深入的使用,Swagger允许自定义展示顺序和字段类型,例如通过替换ServiceModelToSwagger2MapperImpl来排序方法,或实现ModelPropertyBuilderPlugin接口来全局修改类型。这样,开发者可以更加直观地管理API接口文档,降低沟通成本,提高开发效率。
Swagger的源码和相关资源可以参考GitHub和Gitee地址,这是一款值得推荐的API接口文档管理工具,它简化了前后端开发者的工作流程,对于团队协作和项目管理有着显著的帮助。
Stirling PDF:开源在线PDF文档编辑工具库源码
Stirling PDF是一个强大且本地托管的在线PDF编辑工具库,通过Docker实现。用户可以对PDF文件执行多种操作,如分割、合并、转换、重组、添加图像、旋转、压缩等,功能全面,满足所有PDF需求。
Stirling PDF确保用户隐私,不发起任何出站请求记录文件或PDF。文件仅在客户端存在,任务执行期间驻留在服务器内存,或在执行时临时保存在文件中。执行后,用户下载的任何文件将从服务器删除。
该库提供多种语言支持,目前共有种语言,允许用户选择并使用。用户可轻松自定义应用程序,通过设置文件settings.yml或环境变量进行配置。settings.yml遵循标准YAML格式,环境变量则覆盖设置文件。额外的custom_settings.yml文件供精通Java和Spring application.properties的用户自定义设置。
Stirling PDF提供后端API接口,允许用户通过自定义脚本编辑PDF。所有API文档均在实例的 /swagger-ui/index.html 页面提供,或通过Stirling-PDF设置中的API按钮访问。
登录验证确保安全性。默认凭据用于登录,登录后用户可以访问帐户设置,修改API密钥,添加新用户等。API使用需提供带有“X-API-Key”的标题及关联的API密钥。
通过上述步骤,用户可以安装、部署、自定义Stirling PDF,安全地访问和编辑PDF文件,并通过API集成到自定义脚本中。所有功能旨在为用户提供高效、安全、灵活的PDF编辑体验。