4.3. 추가 OAS 사양 정보

문서가 OAS Petstore 문서처럼 보이려면 관련 Petstore swagger.json 파일과 같은 Swagger 호환 사양을 만들어야 합니다. 이 사양을 기본으로 사용하여 ActiveDocs를 테스트할 수 있습니다. 그러나 이 API는 해당 API가 아닙니다.

OAS는 JSON으로 인코딩된 해시에 매핑되는 리소스 선언을 사용합니다. Petstore swagger.json 파일을 예제로 사용하고 각 오브젝트에 대해 알아보십시오.

오브젝트가 아닌 매개변수는 프리미티브 데이터 유형을 사용합니다. Swagger에서 기본 데이터 유형은 JSON-Schema Draft 4 에서 지원하는 유형을 기반으로 합니다. 추가 기본 데이터 유형 파일이 있지만 3scale은 API 끝점에 CORS가 활성화된 경우에만 사용합니다. CORS를 활성화하면 업로드가 api-docs 게이트웨이를 통과하지 않으며, 이 게이트웨이는 거부됩니다.

현재 OAS는 다음 dataTypes 를 지원합니다: