OpenAPI 3.0 문서에 대한 제한사항

OpenAPI 3.0 REST API를 사용할 때 다음 제한사항을 고려하십시오.

• 외부 참조가 포함된 OpenAPI 3.0 문서를 가져와 적용할 수는 있지만, IBM App Connect Enterprise Open API Editor를 사용하여 이러한 문서를 편집할 수는 없습니다.
• IBM App Connect Enterprise 툴킷 을 사용하면 한 번에 하나의 OpenAPI 3.0 문서만 편집할 수 있습니다.
• 단일 통합 서버에 배치되는 모든 REST API의 기본 경로는 고유해야 합니다. 동일한 기본 경로를 사용하여 다른 REST API가 배치된 경우 REST API를 통합 서버에 배치할 수 없습니다.
• OpenAPI 편집기가 열리면 REST API 편집기는 '읽기 전용' 모드로 설정됩니다. OpenAPI 편집기의 작성, 편집, 삭제 서브플로우 단추만 활성입니다.
• 사용할 수 있습니다 OpenAPI 3.0 여러 서버 객체를 포함하는 문서이지만, 각 객체의 기본 URL 는 동일해야 합니다. 서버 변수를 사용하여 서버 오브젝트의 URL 템플리트에 있는 값을 대체하는 서버 템플리트를 사용할 수 없습니다.
• OpenAPI 3.0 스펙의 일부 측면은 현재 사용자 인터페이스에서 지원되지 않습니다. 이러한 상황에서 Open API 편집기의 소스 보기를 사용하여 스펙 텍스트를 직접 편집할 수 있습니다.
• 사용자 인터페이스는 현재 조작의 요청 본문에서 요청 본문 구성요소 참조를 지원하지 않습니다. 요청 본문 구성요소를 참조하려면 다음 예에 표시된 대로 OpenAPI 소스에서 직접 조작의 요청 본문에 참조를 추가하십시오.

  requestBody: $ref: '#/components/requestBodies/request_body_component_name'

  참조는 사용자 인터페이스의 요청 본문에 대한 세부사항 페이지에서 확인됩니다.
• 일부 OpenAPI 3.0 오브젝트는 App Connect Enterprise에서 REST API 프로젝트를 작성할 때 무시됩니다.
  • IBM App Connect Enterprise 에 따르면 OpenAPI 3.0 문서에서 쿠키 데이터 매개변수가 허용되지만, LocalEnvironment.REST.Input.ParametersHTTP 의 Input 헤더 내 쿠키 필드를 파싱하는 기능은 지원되지 않습니다.
  • OpenAPI ( 3.0 ) 문서에서는 복합형 매개변수의 사용이 허용되지만, IBM App Connect Enterprise 은 현재 복합형 매개변수의 구문 분석이나 매핑을 지원하지 않습니다.