本周,我们带来的分享如下:
- 七个高质量API风格示例
- 推荐工具:BankGround
七个高质量API风格示例
统一的API设计至关重要,可以确保API以标准方式运行、以相同方式处理错误、以及能够用标准的方式进行测试。本周,NordicAPI列出了七个最受欢迎的API风格样式,这些统一的API设计对安全团队执行设计和代码审查测试有很大的帮助。
七个高质量API风格示例:
• Agenzia per l'Italia API Design Style Guide:该设计指南来自意大利数字通讯社(Agenzia per l'Italia Digital),由意大利政府创建,旨在帮助促进意大利最高水平的技术创新。
• Adidas API设计风格指南:该设计指南是一个清晰度较高的模型,是不熟悉技术文档的API设计人员和开发人员的理想选择。
• Stoplight API设计风格指南:是一个协作式API设计平台,让每个人都在同一页面上处理API。
• Atlassian API设计风格指南:该设计指南侧重于REST模块的实现细节,致力于在应用程序中创建标准化的REST API。
• Heroku API设计风格指南:Heroku的API设计风格指南托管在GitHub上,可以自动提供大多数开发人员熟悉的统一格式,可以通过GitBook浏览。
• GitLab API设计风格指南:拥有详细的代码片段和示例,可以使开发人员更轻松地将示例复制并粘贴到其开发项目中。
• Apiary API设计风格指南:提供明确和直接的API设计风格指南的优秀示例,可以让协作者轻松设计和部署API。
NordicAPIs推荐了其他几个优秀指南,即:
• 创建API设计样式指南的提示
• API最佳实践
• REST设计技巧
• 特定的命名惯例
推荐工具:BankGround
BankGround是一个银行游乐场,是一个学习REST/OpenAPI和GraphQL API的开源项目。该项目是Karel Husa的创意,提供API安全培训和测试服务,可以使用简单易懂的API开设账户并像在银行一样进行交易。
该工具设计精良,在GitLab中有一个OpenAPI定义和一个源代码存储库,作为易受攻击的API,现在成为了OSS(Operation Support Systems 运营支撑系统)供大家使用,深受API安全学习人员们的广泛欢迎。
感谢 APIsecurity.io 提供相关内容