apiblueprint - Api Blueprint 中的语义问题抱怨忽略额外的响应标头

Question

在Apiary创建 API 蓝图时，我在蓝图 markdown 中遇到了一个错误，该错误被标记为消息的语义问题：

第 21 行 - 忽略额外的响应标头，改为在引用的模型定义中指定此标头。

第 21 行是引用 [Cars][] 模型定义的行。我不想指定任何标题，我对这条消息试图指示我做什么感到困惑。任何人都可以阐明这个问题吗？

格式：1A

# 汽车行业

# 团体车

## 汽车 [/汽车]

+ 模型（应用程序/json）

    + 身体

            {
              “名称”：“金牛座”
            }

### 列出所有汽车 [GET]

+ 响应 200（应用程序/json）

    [汽车][]

+ 响应 401

+ 响应 403

+ 响应 500

+ 回复 503

Answer 1

戈登，你定义(application/json)了两次。只需在响应中删除它：

FORMAT: 1A

# Automative Industry

# Group Cars

## Cars [/cars]

+ Model (application/json)

    + Body

            {
              "name": "Taurus"
            }

### List all cars [GET]

+ Response 200

    [Cars][]

+ Response 401

+ Response 403

+ Response 500

+ Response 503