使用招搖，我如何定義持續時間參數？

Question

在我使用的其中一個請求中，我希望某個屬性是一個瞬間持續時間。

如何在Swagger描述符中定義？

據我瞭解，像

type: string 
format: iso8601 

將是一件好事。但是這是正確的方式嗎？

編輯持續時間將使用ISO8601 durations表示。這意味着它們會在形式

• P1D爲期一天時間
• P1Y2D了一年爲期兩天

Answer 1

我選擇了以下解決方案

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

我使用string類型作爲值作爲字符串傳輸，並使用iso8601格式，這是dat的父級格式es和持續時間。