在Api Blueprint MSON中有没有像excel表这样的json模式？

Question

在Api Blueprint MSON中有没有像excel表这样的json模式？

我正在设计一些在几个客户端之间的api。所以我需要api文档工具，可以呈现为易于阅读的格式。我搜索了这3个解决方案。(Swagger，RAML，Api Blueprint)。我之所以选择Api Blueprint，是因为它可以通过markdown呈现更丰富的表单。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

Answer 1

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