完全掌握 Swagger 中 allOf 的基本原理

Swagger 提供了一个名为 allOf 的特性，它是通过扩展已有的数据模型来构造更为复杂的数据结构的有效手段。这一特性主要用于数据模型的继承及属性的组合，有效减少了代码重复，同时增强了代码的可维护性与清晰度。访问 Swagger 官方网站可以获得更多关于S...

swagger API 接口文档后端程序员教程 API 文档

2024-05-11

0 247

Swagger 导入 Postman 的新手指南

在现代软件开发中，Swagger 和 Postman 作为 API 设计、开发和测试的利器，都被广泛应用。可以将 Swagger 定义的 API 导入到 Postman 中，充分利用 Postman 强大的测试特性对接口进行深入测试。以 Swagger Petstore 项目为...

postman swagger API 接口文档 API 文档教程后端前端程序员接口开发

2024-01-17

0 314

Swagger annotations （注解）入门到精通

Swagger 提供的注解集是其框架中定义 API 规范和文档的重要工具。这些注解在代码里标注重要部分，为 Swagger 的解析工作铺路，进而生成详尽的 API 文档。开发者编写的注释能够被转换成直观的文档，并展现API端点、参数和响应等信息。这不仅提升了开发人员对 API 运作的理解与沟通，也使...

swagger api api文档接口文档程序员后端前端软件开发

2023-12-22

0 475

从零到一掌握 Swagger Array：完整指南和应用案例

Swagger 允许开发者定义 API 的路径、请求参数、响应和其他相关信息，以便生成可读性较高的文档和自动生成客户端代码。而 Array （数组）是一种常见的数据结构，用于存储和组织多个相同类型的数据元素。数组可以有不同的维度和大小，通过索引访问特定位置的元素。 Swagger 中对 Array ...

swagger API 文档接口文档后端开发工具接口开发 java web 开发

2023-12-08

0 585

掌握 Swagger enum：扩展功能和高级用法详解

enum 是 Swagger 规范中用来定义枚举类型的一种方式。它允许开发者在 API 文档中明确列出该接口的参数、返回值或请求体中可接受的枚举值。通过使用 Swagger enum，开发者可以更清晰地描述 API 的输入和输出，提高 API 文档的可读性和可维护性。 enum 使用场景在以下情...

swagger enum API 文档接口文档 API 程序员前端后端接口开发

2023-11-10

0 434

实用技巧：解决 Swagger API 未授权访问漏洞问题

Swagger 是一个用于设计、构建、文档化和使用 RESTful 风格的 Web 服务的开源软件框架。它通过提供一个交互式文档页面，让开发者可以更方便地查看和测试 API 接口。然而，在一些情况下，未经授权的访问可能会导致安全漏洞。本文将介绍如何解决 Swagger API 未授权访问漏洞问题。 ...

Java swagger API 程序员最佳实践 swagger API 后端前端教程

2023-10-27

0 4303

Swagger 自动生成 Api 文档：简化文档生成的工具

自动生成 API 文档的好处不言而喻，它可以提供给你的团队或者外部协作者，方便 API 使用者准确地调用到你的 API。为了降低手动编写文档带来的错误，很多 API 开发者会偏向于寻找一些好的方法来自动生成 API 文档。本文将会介绍一些常用的文档生成工具：开源工具 Tapir，商业化产品 Apif...

API API 文档接口文档自动生成 java 后端接口程序员 swagger

2023-07-26

0 764

新来个技术总监，给团队引入了这款开发神器，同事直呼哇塞！

我在一家做微信营销的公司干技术 leader，带 40 多个人，公司名就不说了。在这个位置上做了好几年，把团队从小带大，公司虽然不算风口浪尖上的高增长业务，但技术这块儿也从来没出过什么问题，我还是蛮自豪的。带团队时间久了，就能发现整个 Team 都渐渐疲了。前两年老板还专门买了个系统搞 OKR，现...

Java API POSTMAN 接口 API接口 swagger jmeter mock 开发效率面试

2022-10-20

0 383

用了这个API协作调试工具，忘记了postman

我如何接触到的 Apifox 今年三四月份的时候，公司已经上线的项目，发现有部分接口存在重复提交的情况，接口也没做好幂等，导致数据库落下了大量重复数据，于是我就开始优化接口，加了redis分布式锁和一些防重校验，好了，背景介绍完毕。锁是加上了，但是吧，要想测试就需要模拟压测环境，这个时候如果完全依...

Java api调试接口调试 postman API 开放API swagger jmeter mock 测试

2022-10-11

0 344

5分钟打造好用好看API文档

5分钟打造好用好看API文档 🤔️ 你是否遇到过这样的场景？对接第三方开放平台文档的时候，左手刷着接口文档看API，右手操作着接口调试工具 🧱 写完接口想交付或提供API文档给第三方使用，又觉得文档展示体验一般？很鸡肋？前言早期第三方开放平台的开放接口文档，主要以信息展示...

C++ Java API API文档 API设计 postman API调试 swagger mock jmeter

2022-09-27

0 320