使用OpenAPI / Swagger规范中的隐式命名元素描述数组

时间:2018-07-04 19:06:42

标签: swagger openapi

说说我的API,出于性能方面的考虑,以JSON数组的形式发送语义上应该是记录的内容。
因此,我们有固定数量的项目数组,每个项目都有自己的名称和类型:

/candles/{id}

[
  [
    "BTC/USD",              // Pair
    1529798400000,          // Open time
    0.00014272,             // Open price
    0.00014298,             // High price
    0.00014249,             // Low price
    0.00014249,             // Close price
    54247.00000000,         // Volume
    1529799299999,          // Close time
    {                       // Taker volume
      base: 14870.00000000,   // buy base asset volume
      quote: 2.12351540       // buy quote asset volume
    },
    7.73785568,             // Quote asset volume
  ],
  ...
]

一个人如何在OpenAPI/Swagger Specification配置文件中对此进行描述? (供swagger-ui消费)

0 个答案:

没有答案