使用 swagger，如何定义持续时间参数？答案

【问题标题】：Using swagger, how can I define a duration parameter?使用 swagger，如何定义持续时间参数？
【发布时间】：2017-08-23 15:23:03
【问题描述】：

在我使用的一个请求中，我希望某个属性是一个持续时间。

如何在 Swagger 描述符中定义它？

据我所知，类似

type: string
format: iso8601

会很好。但这样做对吗？

EDIT 持续时间将使用ISO8601 durations 表示。这意味着它们将采用以下形式

P1D 为期一天
P1Y2D 为期一年零两天

【问题讨论】：

什么是样本持续时间值？

标签： json swagger duration

【解决方案1】：

我选择了以下解决方案

 warrantyDuration:
   type: string
   format: iso8601
   description: Warranty duration expressed as an iso8601 duration. Typical values are P1Y, P2Y, ...
   example: P1Y

我使用 string 类型作为值作为字符串传输，并使用 iso8601 格式，这是日期和持续时间的父格式。

【讨论】：