资源组中的API蓝图页面链接?

时间:2018-06-06 20:19:30

标签: html api markdown apiblueprint apiary

我正在Blueprint中编写产品数据API,并且我想在styleNumber参数中为资源下方的# Group Value References提供一个链接。

## GET Details for products that match any combination of the parameters below [/productservice/products/{?language,styleNumber}]

### Product Service (Products) [GET]
+ Parameters

    + language (array[string],optional)-_One or more 2 letter language codes ([ISO 639-1](https://www.loc.gov/standards/iso639-2/php/code_list.php) format, comma separated)_
    + styleNumber (array[string],optional)-_One or more 5 digit proprietary product style IDs (comma separated) See **[Value References](#Group Value References)**._

我能够在language参数中插入到外部页面的工作链接,但传统的降价页面链接和定义的html名称的链接似乎在语义上对Apiary都无效。有没有办法做到这一点?

1 个答案:

答案 0 :(得分:0)

尝试

    ... See [Value References](/reference/value-references)._

它必须是实际标题的路径,而不是标题。

URI不能包含空格等,这就是为什么你没有设计工作的原因。我相信#value-references意味着作为URI锚点工作,但它在Apiary文档中不起作用。也许是一个错误,但也许是设计。