diff --git a/schema/openapi.yml b/schema/openapi.yml index c649d5a..384b472 100644 --- a/schema/openapi.yml +++ b/schema/openapi.yml @@ -9,7 +9,7 @@ info: url: https://github.com/GiganticMinecraft/seichi-api-schema/blob/main/LICENSE servers: - - url: 'http://localhost:9000' + - url: "http://localhost:9000" description: seichi-portal-backend(開発環境) components: @@ -24,14 +24,14 @@ security: paths: /forms: - $ref: './paths/forms/index.yml' + $ref: "./paths/forms/index.yml" /forms/{formId}: - $ref: './paths/forms/specifyForm/index.yml' + $ref: "./paths/forms/specifyForm/index.yml" /forms/answers: - $ref: './paths/forms/answers/index.yml' + $ref: "./paths/forms/answers/index.yml" /forms/answers/comment: - $ref: './paths/forms/answers/comment/index.yml' + $ref: "./paths/forms/answers/comment/index.yml" /forms/{formId}/answers: - $ref: './paths/forms/specifyForm/answers/index.yml' + $ref: "./paths/forms/specifyForm/answers/index.yml" /forms/labels: - $ref: './paths/forms/labels/index.yml' + $ref: "./paths/forms/labels/index.yml" diff --git a/schema/paths/forms/answers/comment/index.yml b/schema/paths/forms/answers/comment/index.yml index 36ab169..28aad27 100644 --- a/schema/paths/forms/answers/comment/index.yml +++ b/schema/paths/forms/answers/comment/index.yml @@ -7,18 +7,18 @@ post: content: application/json: schema: - $ref: '../../../../types/forms/definitions.yml#/definitions/comments' + $ref: "../../../../types/forms/definitions.yml#/definitions/comments" responses: - '200': + "200": description: コメント成功 - '400': - $ref: '../../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../../errors/errorResponses.yml#/components/responses/internalServerError" delete: operationId: deleteComment @@ -29,18 +29,18 @@ delete: content: application/json: schema: - $ref: '../../../../types/forms/definitions.yml#/definitions/comment_id' + $ref: "../../../../types/forms/definitions.yml#/definitions/comment_id" responses: - '200': + "200": description: コメントの削除成功 - '400': - $ref: '../../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../../errors/errorResponses.yml#/components/responses/internalServerError" patch: operationId: editComment @@ -51,15 +51,15 @@ patch: content: application/json: schema: - $ref: '../../../../types/forms/definitions.yml#/definitions/comment_for_edit' + $ref: "../../../../types/forms/definitions.yml#/definitions/comment_for_edit" responses: - '200': + "200": description: コメント編集成功 - '400': - $ref: '../../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/paths/forms/answers/index.yml b/schema/paths/forms/answers/index.yml index 80ddf58..adc3e87 100644 --- a/schema/paths/forms/answers/index.yml +++ b/schema/paths/forms/answers/index.yml @@ -6,14 +6,14 @@ post: required: true content: application/json: - schema: - $ref: '../../../types/forms/definitions.yml#/definitions/answers' + schema: + $ref: "../../../types/forms/definitions.yml#/definitions/answers" responses: - '200': + "200": description: 回答に成功 - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/paths/forms/index.yml b/schema/paths/forms/index.yml index 3efd9f2..264066d 100644 --- a/schema/paths/forms/index.yml +++ b/schema/paths/forms/index.yml @@ -11,27 +11,27 @@ post: content: application/json: schema: - $ref: '../../types/forms/definitions.yml#/definitions/form' + $ref: "../../types/forms/definitions.yml#/definitions/form" responses: - '201': + "201": description: フォームの作成に成功 content: application/json: schema: - $ref: '../../types/forms/definitions.yml#/definitions/id' + $ref: "../../types/forms/definitions.yml#/definitions/id" headers: Location: description: 作成されたフォームへのURL schema: type: string - '400': - $ref: '../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../errors/errorResponses.yml#/components/responses/unauthorized' - '403': - $ref: '../../errors/errorResponses.yml#/components/responses/forbidden' - '500': - $ref: '../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../errors/errorResponses.yml#/components/responses/unauthorized" + "403": + $ref: "../../errors/errorResponses.yml#/components/responses/forbidden" + "500": + $ref: "../../errors/errorResponses.yml#/components/responses/internalServerError" get: operationId: listForms summary: フォームの一覧を取得する @@ -68,7 +68,7 @@ get: minimum: 1 required: false responses: - '200': + "200": description: フォーム一覧の取得に成功 content: application/json: @@ -77,10 +77,10 @@ get: uniqueItems: true minItems: 1 items: - $ref: '../../types/forms/definitions.yml#/definitions/form' - '400': - $ref: '../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../errors/errorResponses.yml#/components/responses/unauthorized' - '500': - $ref: '../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../types/forms/definitions.yml#/definitions/form" + "400": + $ref: "../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../errors/errorResponses.yml#/components/responses/unauthorized" + "500": + $ref: "../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/paths/forms/labels/index.yml b/schema/paths/forms/labels/index.yml index 7d5310f..7d63cd5 100644 --- a/schema/paths/forms/labels/index.yml +++ b/schema/paths/forms/labels/index.yml @@ -3,20 +3,20 @@ get: summary: 指定した種類のラベルをすべて取得する description: 指定されたものに対してつけられるラベルをすべて取得する parameters: - - $ref: '../../../types/forms/parameters.yml#/parameters/form_label_target' + - $ref: "../../../types/forms/parameters.yml#/parameters/form_label_target" responses: - '200': + "200": description: すべての指定ラベルの取得成功 content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/form_labels' - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../../types/forms/definitions.yml#/definitions/form_labels" + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" post: operationId: createFormLabel @@ -28,16 +28,16 @@ post: content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/form_label' + $ref: "../../../types/forms/definitions.yml#/definitions/form_label" responses: - '200': + "200": description: "ラベルの作成に成功" - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" delete: operationId: deleteFormLabel @@ -49,15 +49,15 @@ delete: content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/form_label_id' + $ref: "../../../types/forms/definitions.yml#/definitions/form_label_id" responses: - '200': + "200": description: "ラベルの削除に成功" - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/paths/forms/specifyForm/answers/index.yml b/schema/paths/forms/specifyForm/answers/index.yml index 2c8bca8..4aa8a13 100644 --- a/schema/paths/forms/specifyForm/answers/index.yml +++ b/schema/paths/forms/specifyForm/answers/index.yml @@ -2,19 +2,19 @@ get: operationId: getFormAnswers summary: 指定したフォームのすべての回答を取得する parameters: - - $ref: '../../../../types/forms/parameters.yml#/parameters/id' + - $ref: "../../../../types/forms/parameters.yml#/parameters/id" responses: - '200': + "200": description: 指定されたフォームの回答の取得に成功 content: application/json: schema: - $ref: '../../../../types/forms/definitions.yml#/definitions/answers' - '400': - $ref: '../../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../../../types/forms/definitions.yml#/definitions/answers" + "400": + $ref: "../../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/paths/forms/specifyForm/index.yml b/schema/paths/forms/specifyForm/index.yml index f0cf1c4..ab2e30a 100644 --- a/schema/paths/forms/specifyForm/index.yml +++ b/schema/paths/forms/specifyForm/index.yml @@ -2,66 +2,66 @@ get: operationId: getForm summary: フォームの詳細を取得する parameters: - - $ref: '../../../types/forms/parameters.yml#/parameters/id' + - $ref: "../../../types/forms/parameters.yml#/parameters/id" responses: - '200': + "200": description: 指定されたフォームIDの情報取得に成功 content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/form' - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../../types/forms/definitions.yml#/definitions/form" + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" delete: operationId: deleteForm summary: フォームを削除する parameters: - - $ref: '../../../types/forms/parameters.yml#/parameters/id' + - $ref: "../../../types/forms/parameters.yml#/parameters/id" responses: - '200': + "200": description: 指定されたFormIdの削除に成功 content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/id' - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../../types/forms/definitions.yml#/definitions/id" + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" patch: operationId: updateForm summary: フォームの値を更新する parameters: - - $ref: '../../../types/forms/parameters.yml#/parameters/id' - - $ref: '../../../types/forms/parameters.yml#/parameters/form_title' - - $ref: '../../../types/forms/parameters.yml#/parameters/form_description' - - $ref: '../../../types/forms/parameters.yml#/parameters/start_at' - - $ref: '../../../types/forms/parameters.yml#/parameters/end_at' - - $ref: '../../../types/forms/parameters.yml#/parameters/webhook_url' + - $ref: "../../../types/forms/parameters.yml#/parameters/id" + - $ref: "../../../types/forms/parameters.yml#/parameters/form_title" + - $ref: "../../../types/forms/parameters.yml#/parameters/form_description" + - $ref: "../../../types/forms/parameters.yml#/parameters/start_at" + - $ref: "../../../types/forms/parameters.yml#/parameters/end_at" + - $ref: "../../../types/forms/parameters.yml#/parameters/webhook_url" responses: - '200': + "200": description: 指定されたFormの更新に成功 content: application/json: schema: - $ref: '../../../types/forms/definitions.yml#/definitions/form' - '400': - $ref: '../../../errors/errorResponses.yml#/components/responses/syntaxError' - '401': - $ref: '../../../errors/errorResponses.yml#/components/responses/unauthorized' - '404': - $ref: '../../../errors/errorResponses.yml#/components/responses/notFound' - '500': - $ref: '../../../errors/errorResponses.yml#/components/responses/internalServerError' + $ref: "../../../types/forms/definitions.yml#/definitions/form" + "400": + $ref: "../../../errors/errorResponses.yml#/components/responses/syntaxError" + "401": + $ref: "../../../errors/errorResponses.yml#/components/responses/unauthorized" + "404": + $ref: "../../../errors/errorResponses.yml#/components/responses/notFound" + "500": + $ref: "../../../errors/errorResponses.yml#/components/responses/internalServerError" diff --git a/schema/types/forms/components.yml b/schema/types/forms/components.yml index e3695b5..38bf27a 100644 --- a/schema/types/forms/components.yml +++ b/schema/types/forms/components.yml @@ -29,9 +29,9 @@ components: nullable: true properties: start_at: - $ref: '#/components/schemas/start_at' + $ref: "#/components/schemas/start_at" end_at: - $ref: '#/components/schemas/end_at' + $ref: "#/components/schemas/end_at" webhook_url: description: webhookのURL type: string @@ -40,9 +40,9 @@ components: type: object properties: response_period: - $ref: '#/components/schemas/response_period' + $ref: "#/components/schemas/response_period" webhook_url: - $ref: '#/components/schemas/webhook_url' + $ref: "#/components/schemas/webhook_url" created_at: description: フォームの作成日時 type: string @@ -56,9 +56,9 @@ components: type: object properties: created_at: - $ref: '#/components/schemas/created_at' + $ref: "#/components/schemas/created_at" updated_at: - $ref: '#/components/schemas/updated_at' + $ref: "#/components/schemas/updated_at" question_id: description: 質問のID type: integer @@ -80,7 +80,7 @@ components: | -------- | ------------| | TEXT | 自由記述 | | MULTIPLE | 複数選択 | - | SINGLE | 単一選択 | + | SINGLE | 単一選択 | type: string enum: - TEXT @@ -92,28 +92,28 @@ components: type: object properties: question_id: - $ref: '#/components/schemas/question_id' + $ref: "#/components/schemas/question_id" question_title: - $ref: '#/components/schemas/question_title' + $ref: "#/components/schemas/question_title" question_description: - $ref: '#/components/schemas/question_description' + $ref: "#/components/schemas/question_description" question_type: - $ref: '#/components/schemas/question_type' + $ref: "#/components/schemas/question_type" questions: description: 質問の配列 type: array uniqueItems: true minItems: 1 items: - $ref: '#/components/schemas/question' + $ref: "#/components/schemas/question" answer: description: 質問に対する回答 type: object properties: question_id: - $ref: '#/components/schemas/question_id' + $ref: "#/components/schemas/question_id" uuid: - $ref: '../users/components.yml#/components/schemas/uuid' + $ref: "../users/components.yml#/components/schemas/uuid" answer: type: string example: 整地鯖にアクセスできません。どうしたらいいですか。 @@ -126,9 +126,9 @@ components: | 名前 | 説明 | | ------------ | --------------------------------------------| | FORM | フォームに対してつけられるラベル | - | FORM_ANSWERS | フォームについた回答に対してつけられるラベル | + | FORM_ANSWERS | フォームについた回答に対してつけられるラベル | type: string - enum: + enum: - FORM - FORM_ANSWERS form_label_id: @@ -160,14 +160,14 @@ components: id: readOnly: true allOf: - - $ref: '#/components/schemas/comment_id' + - $ref: "#/components/schemas/comment_id" content: - $ref: '#/components/schemas/comment_content' + $ref: "#/components/schemas/comment_content" comment_for_edit: description: コメント type: object properties: id: - $ref: '#/components/schemas/comment_id' + $ref: "#/components/schemas/comment_id" content: - $ref: '#/components/schemas/comment_content' + $ref: "#/components/schemas/comment_content" diff --git a/schema/types/forms/definitions.yml b/schema/types/forms/definitions.yml index 43fa60d..9501e2a 100644 --- a/schema/types/forms/definitions.yml +++ b/schema/types/forms/definitions.yml @@ -6,23 +6,23 @@ definitions: id: readOnly: true allOf: - - $ref: './components.yml#/components/schemas/id' + - $ref: "./components.yml#/components/schemas/id" title: - $ref: './components.yml#/components/schemas/title' + $ref: "./components.yml#/components/schemas/title" description: - $ref: './components.yml#/components/schemas/description' + $ref: "./components.yml#/components/schemas/description" settings: readOnly: true allOf: - - $ref: './components.yml#/components/schemas/settings' + - $ref: "./components.yml#/components/schemas/settings" metadata: readOnly: true allOf: - - $ref: './components.yml#/components/schemas/metadata' + - $ref: "./components.yml#/components/schemas/metadata" questions: readOnly: true allOf: - - $ref: './components.yml#/components/schemas/questions' + - $ref: "./components.yml#/components/schemas/questions" required: - id - title @@ -30,7 +30,7 @@ definitions: type: object properties: id: - $ref: './components.yml#/components/schemas/id' + $ref: "./components.yml#/components/schemas/id" required: - id answers: @@ -39,62 +39,62 @@ definitions: uniqueItems: true minItems: 0 items: - $ref: './components.yml#/components/schemas/answer' + $ref: "./components.yml#/components/schemas/answer" kind_of_labels: type: object properties: kind_of_labels: - $ref: './components.yml#/components/schemas/kind_of_labels' + $ref: "./components.yml#/components/schemas/kind_of_labels" required: - kind_of_labels form_label_id: type: object properties: id: - $ref: './components.yml#/components/schemas/form_label_id' + $ref: "./components.yml#/components/schemas/form_label_id" required: - id form_label: description: フォームに対してつけるラベル type: object properties: - id: - $ref: './components.yml#/components/schemas/form_label_id' + id: + $ref: "./components.yml#/components/schemas/form_label_id" kind_of_labels: - $ref: './components.yml#/components/schemas/kind_of_labels' + $ref: "./components.yml#/components/schemas/kind_of_labels" name: - $ref: './components.yml#/components/schemas/form_label_name' + $ref: "./components.yml#/components/schemas/form_label_name" description: - $ref: './components.yml#/components/schemas/form_label_description' + $ref: "./components.yml#/components/schemas/form_label_description" form_labels: description: フォームラベルの配列 type: array uniqueItems: true minItems: 0 items: - $ref: '#/definitions/form_label' + $ref: "#/definitions/form_label" comment_id: description: コメントのID type: object properties: id: - $ref: './components.yml#/components/schemas/comment_id' + $ref: "./components.yml#/components/schemas/comment_id" comment: description: 単一のコメント type: object properties: comment: - $ref: './components.yml#/components/schemas/comment' + $ref: "./components.yml#/components/schemas/comment" comment_for_edit: description: 単一のコメント type: object properties: comment: - $ref: './components.yml#/components/schemas/comment_for_edit' + $ref: "./components.yml#/components/schemas/comment_for_edit" comments: description: コメントの配列 type: array uniqueItems: true minItems: 0 items: - $ref: './components.yml#/components/schemas/comment' + $ref: "./components.yml#/components/schemas/comment" diff --git a/schema/types/forms/parameters.yml b/schema/types/forms/parameters.yml index f6478bf..decf57c 100644 --- a/schema/types/forms/parameters.yml +++ b/schema/types/forms/parameters.yml @@ -5,21 +5,21 @@ parameters: description: フォームID required: true schema: - $ref: './components.yml#/components/schemas/id' + $ref: "./components.yml#/components/schemas/id" form_title: name: title in: query description: フォームのタイトル required: false - schema: - $ref: './components.yml#/components/schemas/title' + schema: + $ref: "./components.yml#/components/schemas/title" form_description: name: description in: query description: フォームの説明 required: false - schema: - $ref: './components.yml#/components/schemas/description' + schema: + $ref: "./components.yml#/components/schemas/description" start_at: name: startAt in: query @@ -29,8 +29,8 @@ parameters: 終了日(`end_at`)が指定されていない場合は失敗する可能性があります。 新たに設定する場合は`start_at`と`end_at`の両方を含めたパラメータを指定してください。 required: false - schema: - $ref: './components.yml#/components/schemas/start_at' + schema: + $ref: "./components.yml#/components/schemas/start_at" end_at: name: endAt in: query @@ -40,19 +40,19 @@ parameters: 開始日(`start_at`)が指定されていない場合は失敗する可能性があります。 新たに設定する場合は`start_at`と`end_at`の両方を含めたパラメータを指定してください。 required: false - schema: - $ref: './components.yml#/components/schemas/end_at' + schema: + $ref: "./components.yml#/components/schemas/end_at" webhook_url: name: webhook in: query description: フォームの変更などを通知するリンク required: false schema: - $ref: './components.yml#/components/schemas/webhook_url' + $ref: "./components.yml#/components/schemas/webhook_url" form_label_target: name: target in: query required: true description: 何に対してのラベルを取得するかを取得するか。 schema: - $ref: './components.yml#/components/schemas/kind_of_labels' + $ref: "./components.yml#/components/schemas/kind_of_labels"