Swagger JSON 샘플에 루트 요소 포함

Question

우리는 REST API에서 XML과 JSON을 모두 입/출력 형식으로 지원하며 Swagger에서 생성 한 샘플 입력에는 JSON 입력에 대한 루트 노드 값이 표시되지 않지만 XML 견본.

REST API에서 JSON의 루트 노드도 예상하므로 샘플에서 루트 노드를 보여주기 위해 Swagger를 만들려면 어떻게해야합니까?

자신감 샘플 XML -

<Request> 
    <EmployeeNumber>string</EmployeeNumber> 
    <Department> 
      <DepartmentId>string</DepartmentId> 
      <DepartmentName>string</DepartmentName> 
      <DepartmentHead>string</DepartmentHead> 
      <DepartmentLocation>string</DepartmentLocation> 
    </Department> 
</Request> 

자신감 샘플 JSON -

{ 
    "EmployeeNumber": "string", 
    "Department": { 
     "DepartmentId": "string", 
     "DepartmentName": "string", 
     "DepartmentHead": "string", 
     "DepartmentLocation": "string" 
    } 
    } 

예상 JSON 샘플 - 자동으로 하나를 생성하는 대신 자신감 주석의 예제 샘플을 제공하는 방법

{ 
    "Request": { 
    "EmployeeNumber": "string", 
    "Department": { 
     "DepartmentId": "string", 
     "DepartmentName": "string", 
     "DepartmentHead": "string", 
     "DepartmentLocation": "string" 
    } 
    } 
} 

?

Answer 1

https://github.com/swagger-api/swagger-core/wiki/annotations

이것 좀보세요. 희망이 당신을 도울 것입니다.