OpenAPI import

If your API publishes an OpenAPI specification (formerly Swagger), Kubme can generate the custom connector for you: endpoint, authentication, actions, entities and mapping.

Supported formats

OpenAPI 3.x;
Swagger 2.0, converted automatically;
in JSON or YAML (.json, .yaml, .yml).

Importing

In a custom connector's Dashboard, on the OpenAPI (Swagger) card, click Import and choose the file.
The Select endpoints to import window lists all the API's routes:
search with Search endpoint...;
filter by method (GET, POST, PUT, PATCH, DELETE) or by group;
Select visible / Deselect visible;
a badge marks the routes that require authentication.
Click Import n endpoints.

To add routes later: Actions step › Add action › Import from OpenAPI (see Actions). Routes already present are skipped.

With Kubme AI

Kubme AI can do the import for you: "Import this specification into my connector, keeping only the order routes." The import asks for your approval (see Approvals).

What Kubme generates

What you have already entered (host, authentication) is kept.

If the import fails

Made with