Create OpenAPI connection

To create a connection to your system, follow these steps:

1. Navigate to Settings  > Data Ingestion > Connections.
2. In the top-right corner, click New connection, find your system, and click Connect.

General configuration

In the general connection configuration step:

1. Nameyour connection for easier identification in Dawiso.
   • Use a unique and descriptive name like the combination of the server name and your local environment naming (e.g., server1_prod).
2. Provide a description (purpose of the connection).
3. Select a Connection type.
   • Shared: Source is accessible from the public internet and you can share your credentials with Dawiso.
   • Private: Source is not accessible from the public internet and you cannot share your credentials with Dawiso. For more information, see the Create a private connection article.
4. Click Next.

Provide file URL and save connection

In this step, enter the full URL to your OpenAPI schema file. This file defines the structure of your API and is typically available in JSON format. For example: https://your-company.com/swagger/v1/swagger.json.

Make sure the schema URL is publicly accessible or accessible from the environment where the ingestion is running. Dawiso must be able to access the file without authentication or network restrictions.

Test and save connection

If your connection is shared, click on Test connection and wait for a few seconds.

• If successful, there will be a green checkmark next to the button.
• In case of failure, there will be a red error icon. Hover over it for a detailed error message. For more information, see the troubleshooting section. You will still be able to save your connection.

Finally, Save the connection and proceed to the next step: using the connection to create a data source. During this process, you will specify what metadata to ingest.