标签: post get swagger documentation-generation openapi
我正在Swaggerhub中记录文本分析API。将大型文档作为GET请求发送到我们的API会在我们端触发HTTP错误414。因此,我们还允许将正文中的文档进行POST请求。
每个端点的GET和POST请求参数完全相同,响应也是如此。有没有什么方法可以在OpenAPI3中优雅地描述这一点而不必每次都重复规范?这样做会使redoc生成的文档不必要地冗长和复杂。