Importing an OpenAPI file

How to import an OpenAPI file

1. Select a repository and branch in the navigation panel and open the context menu () of the selected branch.
2. Select "Import OpenAPI definition".
3. Now, an OpenAPI file needs to be provided. You can choose between two sources that need to be a valid OpenAPI 3.0 or 3.1 file in JSON or YAML format: 
   1. Upload from a local file: You can select a file from your local storage. 
   2. Import from a URL: Alternatively, you can provide a direct URL link to the OpenAPI file for import and select "Fetch from URL". You can for example use the OpenAPI feed of a Blueriq webservice. Read here how to get its URL.  
4. Select the project and module in which you want to import the file.
5. Proceed to the next step to select which operation operations you wish to import.

   Certain features described in a valid OpenAPI file may not be supported by Blueriq. During the import process, unsupported features are identified for each operation and are ignored where applicable, allowing the import to continue smoothly without interruption.

6. After selecting "Import", all generated elements will be saved and the newly created REST service elements will be opened automatically

Model generation and support

The OpenAPI import in Blueriq Encore generates a model based on an OpenAPI 3.0 or 3.1 file in JSON or YAML format. 

Some things to consider about the model generation are:

• Element types that may be created during this import include: Interaction module, Entity, Relation, Attribute, Value list, REST service, Domain schema.
• For each path object in the OpenAPI file, a REST Service will be generated. 
• For each schema in the OpenAPI file, a domain schema will be generated.
• If an element already exists in the module, a suffix will be added to the element name.
• Supported HTTP methods are: GET, POST, PUT, DELETE, PATCH.
• Supported media types are: application/json and application/xml.
• Security schemes are not supported.
• Blueriq can only handle one response schema. This will be the schema that corresponds with the status code 200 (or default or lowest code if 200 does not exist).
• OpenAPI examples and descriptions are ignored during the import.

Consuming vs. creating a webservice

The OpenAPI import in Blueriq Encore is designed for consumption of a webservice. You may however choose to expose the imported operations as a webservice operated by Blueriq by creating a webservice in a configuration module and changing the direction of the REST service from 'Outgoing' to 'Incoming' or 'Both'.