スワッガーで投稿要求からオブジェクトフィールドを削除する方法

Question

私は、id、first_name、last_name、created_atで定義されたユーザーモデルを持っているとします。

ユーザーを作成するPOST要求には、first_nameとlast_nameが必要です。どのように私はそれを誇張して書くだろうか？スワッガーは単一のオブジェクトを期待しています。私はそのために新しいオブジェクトを作成すべきですか？

Answer 1

first_nameとlast_nameを必須フィールドとしてマークすることができます。次に例を示します。

required: 
    - first_name 
    - last_name 

は、文献：https://github.com/swagger-api/swagger-codegen/blob/master/modules/swagger-codegen/src/test/resources/2_0/petstore.yaml#L658-L660（つまり、別のオブジェクトを作成する必要はありません）

Answer 2

どの程度

myuser: 
    allOf: 
    - $ref: '#/definitions/myuserbase' 
    - type: object 
    properties: 
     id: 
     description: | 
      Unique identifier for the classifier. 
     type: string 
     example: user1 
     created_at: 
     description: | 
      Date and time the user was created. 
     type: string 
     format: date-time   
    required: 
     - id 

と

myuserbase: 
    type: object 
    properties: 
     first_name: 
     description: | 
      First name of the user 
     type: string 
     last_name: 
     description: | 
      Last name of the user 
     type: string 
    required: 
     - first_name 
     - last_name