在Api Blueprint MSON中是否有像excel表一样的json架构?

时间:2017-03-13 06:13:07

标签: json jsonschema apiblueprint mson aglio

是否有像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

1 个答案:

答案 0 :(得分:1)

Aglio目前不支持此功能。您可以编写自定义主题布局或主题引擎来支持此功能。