OpenAPITools / OpenAPITools/openapi-generator

[Integromat] Create a client for creating Integromat apps

Open
#10,823 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Java
Stars
26.8k
Forks
7.7k
PR merge metrics
PR metrics pending

Description

Description

Integromat is an Enterprise Integration Platform as a Service (IPaaS) that allows the creation of apps to abstract APIs of over 800 existing apps. The key challenge for any vendor with an API is to quickly stand up an app that allows any Integromat customer to quickly start automating scenarios with their API-driven product.

The Integromat Developer SDK is readily available through Integromat with a variety of Integromat-specific JSON outputs that "builds" the app. This includes connections via oAuth and keys, modules, webhooks, RPCs and calling IML functions.

The exercise of converting all of even part of an arbitrary API is currently cumbersome, takes a lot of time. As a result many Integromat apps are partially complete, not well maintained and frankly are not a good representation of an API. Most importantly it is quite a bit of work to standup an app and the work is left to either Integromat or the API developer.

For example the Vimeo app is just a fraction of the functionality of what the Vimeo APP provides. Only 5 modules are available and there are at least 20 endpoints that can give the Integromat user much more capability to automate with Vimeo. It is also missing the all important "Make API Call" module which would allow an Integromat user to call an API not yet implemented using the built in authentication already established. Vimeo could use OpenAPI generator to quickly revise their module and update it quickly, easily and most importantly in an AUTOMATED fashion. Testing is the only part that would be required.

A Chrome extension Integromat app importer was created by Integromat, and it imported the Swagger OpenAPI spec. Unfortuantely it is not being well maintained and has been shelved.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Integromat Developer SDK documentation and the referenced Chrome extension importer to understand the expected app JSON and OpenAPI input. Define the scope for creating Integromat apps from OpenAPI specifications, including authentication, modules, webhooks, RPCs, and IML functions. Done should include the requested client capability and tests covering its generated output.

Written by the indexing model from the issue text.

Assessment

Tech stack
java, openapi
Domain
api, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.