假设我有一个API,它创建了一个资源,比如/create/my-resource/<resource-id>。我希望api的使用者知道,响应总是有一个id字段与url中传递的id字段相匹配,即:<resource-id>。
我知道我可以使用api示例来为给定的id演示这一点,比如2。但是,是否有一种方法可以泛泛地、纯粹地使用开放api来描述这个问题呢?其想法是在嘲弄时使用上述行为。
发布于 2022-11-02 18:48:19
OpenAPI没有相应的语法。您只能在description中或使用自定义x- 扩展记录此类行为。
可以在这里建议对OpenAPI语法进行增强:
https://stackoverflow.com/questions/74292805
复制相似问题