我一直在使用API Blueprint格式来设计API,并从中获得了很多乐趣。当我声明我的数据结构时,我遇到了代码重用或模型重用问题。
根据文档,在声明响应时,必须这样做:
例如:
+ Request 200 (application/json)但是,当多个人处理文档时,我不想指示他们使用什么返回代码,因为我们已经定义了它们,而且它们是数字,所以人们会忘记它们。因此,为了避免来回奔波,我的想法是可以使用/引用其中一个属性:
# Data Structures
## HttpCode (object)
+ success: 200 - Request processed successfully
+ not_found: 404 - Content requested not found
+ forbidden: 403 - Access to content is forbidden我会这样引用它:
+ Response (HttpCode.success) (application/json)
...它显然不起作用,我在文档中找不到任何与我想要做的事情相关的东西。也许我错过了。
那么你是怎么做的呢?有可能吗?
谢谢!
发布于 2018-04-11 05:52:51
这是不可能的。他们在GitHub的代表关闭了我的问题。https://github.com/apiaryio/api-blueprint/issues/411
https://stackoverflow.com/questions/47849041
复制相似问题