Developing a piece Step-by Step

Here is the best idea: OpenAPI/Swagger to Piece - It’s almost 2025, and almost TWO YEARS since GPT launched.

I think there should be a “magical” transformation from a Swagger spec to an ActivePieces Piece.
Here’s Perplexity’s take:
While Swagger/OpenAPI specifications remain industry standards for API documentation and design, automatically transforming these specs into ActivePieces Pieces isn’t currently a built-in feature. However, this idea has merit and could potentially streamline the process of creating custom Pieces.A more realistic approach for the ActivePieces community might be:

  1. Develop a tool or extension that uses Swagger/OpenAPI specs as a starting point to generate Piece templates or scaffolding.
  2. Create a workflow that assists developers in translating key elements from a Swagger spec (endpoints, parameters, response structures) into the ActivePieces Piece framework.
  3. Explore ways to leverage OpenAPI tooling, like Swagger Codegen, to automate parts of the Piece creation process, such as generating TypeScript interfaces or API client code.

While not a ‘magical’ transformation, these approaches could significantly reduce the manual work required to create Pieces from existing API specifications, making it easier for the community to expand ActivePieces’ integration capabilities.

I ran this on bolt.new - I am not sure whether Bolt quit finding errors to fix or I ran out of tokens first. [The project is public] (Swagger to ActivePieces Converter)

As I ran out of tokens, Bolt was offering to either convert the code to an npm module that could be installed globally and/or convert it to a web app, which is, of course, the more interesting option.