2016-12-06 5 views

답변

2

상대 스키마 파일을 사용할 수 있습니다. 예 :

$ref: 'Pet.yaml' 

참조 : https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#relative-schema-file-example

자신감 파일이 연결되지 않은 경우/서로 관련, 당신은 하나의 파일로 자신감 파일을 결합하고 작업을 분류하는 tags를 사용해야합니다. 예 :

+0

wing383 감사합니다 @,이 마스터 자신감이 파일이 어떻게 든 함께 그들을 모두 연결이 생성되어야 함을 제안 하는가? 현재 여섯 개의 JSON swagger 파일이 있으며 모두 자신의 정보와 태그를 가지고 있으며 함께 하나의 API를 정의합니다. 이것은 드문 접근 방법입니까? – LookingToLearn

+0

너무 많은 엔드 포인트/연산을 하나의 API에 넣지 않으려 고하기 때문에 거대한 API를 여러 개의 Swagger 사양으로 더 작은 API로 분류하는 것을 보았습니다. SDK의 크기가 특정 시나리오에서 문제가 될 수 있으므로 SDK 크기를 작게 유지하는 것은 좋지 않습니다. API를 하나의 API로 결합 할 것인가 아닌가는 실제로 유스 케이스로 이어진다. –

+0

고마워요, 비록 내가 아직도 로컬 사용을 위해 그들을 결합하는 방법이나 $ ref가 도움이되는지 잘 모르겠지만. 필자는 소스 코드를 사용하여 작업하고 있습니다. 필자가 일하는 회사는 문서를 공용으로 사용하기 위해 파일을 하나의 파일로 결합했습니다. 테스트를하는 동안 로컬에서 동일한 작업을 수행하기를 원합니다. 수동으로 복사하여 붙여 넣기하거나 스크립트를 함께 해킹하지 않아도됩니다. – LookingToLearn

관련 문제