Mule 如何在RAML输出中动态包含/排除API块
我只是想了解在由RAML生成的文档中排除/包括端点的可能性是什么 例如,给定Mule 如何在RAML输出中动态包含/排除API块,mule,mulesoft,raml,Mule,Mulesoft,Raml,我只是想了解在由RAML生成的文档中排除/包括端点的可能性是什么 例如,给定 #%RAML 1.0 baseUri: https://api.mybanks.com/v1 title: MyBanks-API version: v1 protocols: [HTTP, HTTPS] mediaType: application/json /banks: get: description: Lists all banks responses: 200:
#%RAML 1.0
baseUri: https://api.mybanks.com/v1
title: MyBanks-API
version: v1
protocols: [HTTP, HTTPS]
mediaType: application/json
/banks:
get:
description: Lists all banks
responses:
200:
body:
text/plain:
example: ['b1', 'b2']
/accounts:
get:
description: List all accounds
responses:
200:
body:
text/plain:
example: ['a1', 'a2', 'a3']
我想从生成的文档中排除/banks
API。有哪些可能的方法可以做到这一点?(最好不要评论)没有办法(AFAIK)动态排除API规范的片段——而且,这样一个特性的语义是什么?i、 这是什么意思?另一个需要考虑的问题是,当您接受规范并开始实现它时,它是如何应用的
现在有一种方法可以使用RAML扩展来扩展现有的API规范
如果使用RAML扩展名
片段,规范将分为两个文件:
1) 根RAML文件:
#%RAML 1.0
baseUri: https://api.mybanks.com/v1
title: MyBanks-API
version: v1
protocols: [HTTP, HTTPS]
mediaType: application/json
/accounts:
get:
description: List all accounds
responses:
200:
body:
text/plain:
example: ['a1', 'a2', 'a3']
2) 扩展名
片段:
#%RAML 1.0 Extension
extends: banks-api.raml
/banks:
get:
description: Lists all banks
responses:
200:
body:
text/plain:
example: ['b1', 'b2']
现在您有两个API视图,(1)根视图和(2)扩展视图。您可以向用户提供根目录或扩展名