Swagger / Open API 3.0链接无法正确呈现

时间:2019-03-22 20:57:53

标签: swagger swagger-ui openapi

我正在创建一个开放的api定义,并尝试定义从一条路线到另一条路线的HATEOAS链接。以下yaml代码已正确解析,但是在运行swagger-ui时,链接显示异常,并显示了operationId的值。这是真的吗?我期待其他的东西,例如链接所描述的路线的超链接。难道我做错了什么?

openapi: 3.0.0
info:
  description: "Foo API"
  version: "1.0.0"
  title: "Foo"
paths:
  /foo: 
    get: 
      summary: Foo 
      operationId: getFoo
      responses: 
        200: 
          description: OK
  /bar: 
    get: 
      summary: Bar
      operationId: getBar
      responses: 
        200: 
          description: OK
          links:
            foo:
              operationId: getFoo

screenshot

0 个答案:

没有答案