是否有像Api Blueprint MSON中的excel表那样的json架构?
我正在为几个客户设计一些api。 所以我需要api文档工具,它可以呈现为易读的格式。 我搜索这3个解决方案。 (Swagger,RAML,Api Blueprint)。 我决定Api蓝图,因为它可以呈现更丰富的形式与降价。 几乎Api Blueprint的每个功能都让我满意。 但是json架构格式非常复杂且难以阅读。 我希望我的结果html如下所示。 (我使用aglio作为Api Blueprint html渲染器。)
这是我的apib源代码
FORMAT: 1A
# GET /MyApi
- Request
- Attributes
- name : hhd (string, required) - this is person name
- age : 37 (number, optional) - this is person age
- pets (array)
- (object)
- name : tom (string, optional) - this is pet's name
- type : dog (string, required) - this is pet's type
- (object)
- name : jane
- type : cat
- Response 200
- Attributes
- status : ok (string, required)
- id : 1000 (number, required)
- name : hhd (string, required) - this is person name
- age : 37 (number, optional) - this is person age
- pets : (array)
- (object)
- id : 10001 (number, required)
- name : tom (string, optional) - this is pet's name
- type : dog (string, required) - this is pet's type
- (object)
- id : 10002
- name : jane
- type : cat
答案 0 :(得分:1)
Aglio目前不支持此功能。您可以编写自定义主题布局或主题引擎来支持此功能。