如何在RFC3339 3.0中记录OpenAPI的日期时间输入？

Question

使用OpenAPI 3.0，我需要记录如何通过HTTP向我的RFC3339端点提供RFC3339日期时间JSON输入。

日期-时间格式示例如下所示：

"2021-06-20T01:02:03+00:00"

参考Swagger文档，我尝试了各种方法，包括：

          content:
            application/json:
                schema:
                    type: object
                    properties:
                        datetime:
                            type: date
                            pattern: /([0-9]{4})-(?:[0-9]{2})-([0-9]{2})T([0-9]{2}):(?:[0-9]{2}):(?:[0-9]{2})+(?:[0-9]{2}):(?:[0-9]{2})/
                            example: "2021-06-20T01:02:03+00:00"
                        example: "2021-06-20T01:02:03+00:00"

         content:
            application/json:
                schema:
                    type: object
                    properties:
                        datetime:
                            type: string
                            description: RFC3339 Datetime to set
                            format: date-time
                            example: "2021-06-20T01:02:03+00:00"

两者都不起作用--两者都在浏览器中呈现Swagger UI中的以下错误：

​

​

​

​

如何在RFC3339 3.0中正确地记录这个DateTime输入？

Answer 1

第二个示例是正确的，并在https://editor.swagger.io中正确呈现-如下所示。

第一个示例无效，它将导致呈现错误，因为第二个example关键字(与datetime一起的关键字)不在此位置。

​

​