App Connect

 View Only

OpenAPI 3.0.0 $ref support for IBM ACE 12.0.12.10

  • 1.  OpenAPI 3.0.0 $ref support for IBM ACE 12.0.12.10

    Posted 14 days ago

    Hi,

    Problem description:

    We are currently using IBM App Connect Enterprise (ACE) version 12.0.12.10 and are encountering significant performance issues when working with large OpenAPI 3.0.0 schema files. Our OpenAPI schema is approximately 90,000 lines long and defines multiple REST API endpoints. This large file size makes the deployment and local development process very slow and unresponsive.

    To address this, we tried splitting the main OpenAPI schema into smaller files and using $ref references to external JSON files that contain the definitions for request and response objects (input/output). Although OpenAPI 3.0.0 supports the use of $ref for external file references, it seems that IBM ACE does not fully support this feature, resulting in errors or deployment failures.

    Our questions are:

    - Is there a known workaround for utilizing $ref references to external JSON files in OpenAPI 3.0.0 within IBM ACE 12.x?
    - Is there a plan to add $ref support for external file references in future releases of IBM ACE?
    - Will IBM ACE version 13.0 support this feature, and if so, when will the developer kit for IBM ACE 13.0 be available for download?

    We would appreciate any guidance or information on this topic.

    Environment Details:

    IBM ACE version: 12.0.12.10
    OpenAPI version: 3.0.0
    Schema size: ~90,000 lines

    Thank you in advance for your support and assistance.



    ------------------------------
    Tomáš Matúšek
    Senior Integration Developer
    Foundation s.r.o.
    Bratislava
    ------------------------------