OpenAPI 3.0 で swagger 形式の YAML を作ってるのですが、API の入力チェック情報の書き方で困っています。
どのブロックにどのプロパティを使って書けばいいのか教えていただきたいです。
-
1api の入力チェック情報とは何を指しているのかもう少し詳しく書いていただくといいと思います。– shimmy06192020年12月15日 7:33
-
文字数チェックや、日付チェック、英数字チェックなど、それぞれのリクエストパラメータに入力された値が正しい形で入力されているかをチェックするものです。– leo2020年12月15日 8:20
コメントを追加
|
1 件の回答
入力項目の長さの最小値、最大値、入力項目の制限はSchema Objectに記述します。
number / integer / string においてはデータの型定義はformat
フィールドを利用して細分化できます。
簡単な例ですが次のようになります。
schema:
type: object
properties:
comment:
type: string
minimum: 0 # 最小 0文字
maximum: 10 # 最大10文字
updateAt:
type: string
format: date # RFC3339に則った日付形式