OPENAPI3规范中的GET或POST对于相同的端点,参数和响应

时间:2018-08-26 11:37:42

标签: post get swagger documentation-generation openapi

我正在Swaggerhub中记录文本分析API。将大型文档作为GET请求发送到我们的API会在我们端触发HTTP错误414。因此,我们还允许将正文中的文档进行POST请求。

每个端点的GET和POST请求参数完全相同,响应也是如此。有没有什么方法可以在OpenAPI3中优雅地描述这一点而不必每次都重复规范?这样做会使redoc生成的文档不必要地冗长和复杂。

0 个答案:

没有答案