【问题标题】:Aglio - API Blueprint - Path variables not showing upAglio - API 蓝图 - 路径变量未显示
【发布时间】:2017-03-29 04:42:40
【问题描述】:

我有一个类似这样的 API 蓝图:

## Organization Users [/organizations/{id}/Users]

         + Parameters

            + id (string, required) - path variable, id of the organization.


some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)

当我用类似的东西运行 Aglio 时:

aglio --theme-variables streak  -i AppServices/Organizations.apib -o Build/AppServices.html

我得到如下输出:

请注意,路径变量根本不存在。

其他事实:

  1. aglio 在生成输出时未显示警告
  2. API 蓝图验证正常。
  3. 我尝试了 aglio 提供的所有主题,结果相同。

【问题讨论】:

标签: rest apiblueprint aglio


【解决方案1】:

Kyle Fuller (https://github.com/kylef) 回答了我关于 Aglio 的 github 问题的问题:

参数部分的意图不正确,因此显示为原始降价描述。

我想你想要这样的东西:

## Organization Users [/organizations/{id}/Users]

+ Parameters
    + id (string, required) - path variable, id of the organization.

some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)

【讨论】:

    猜你喜欢
    • 2015-02-23
    • 2014-01-24
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2014-09-23
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多