OpenAPITools/openapi-generator

[REQ] Add generator for Apigee Edge Policy Bundles

Open

#1,940 opened on Jan 18, 2019

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Java (7,516 forks)batch import
Enhancement: FeatureEnhancement: New generatorHacktoberfesthelp wanted

Repository metrics

Stars
 (26,243 stars)
PR merge metrics
 (Avg merge 9d 1h) (123 merged PRs in 30d)

Description

I would like to use OpenAPI 3.0 instead of 2.0. I want to use Apigee edge as my API proxy, but Apigee only supports creating proxies based on 2.0. Luckily server stub and client sdk is good enough with 3.0, so that leaves getting the proxy as my last hurdle to using 3.0.

Describe the solution you'd like

OpenAPI-generator could generate Apigee policy bundles similar to openapi2apigee. https://github.com/anil614sagar/openapi2apigee (Sadly that project hasn't been maintained for 2-3 years, and, since 3.0 was released 1.5 years go, it can't have support for 3.0 specs).

Describe alternatives you've considered

Apigee has been saying 3.0 support "is coming" in their support forum since before 3.0 was released. I've also looked at other tools like openapi2apigee.

Additional context

In the end, the apigee APIs for creating/updating proxies expect a Policy Bundle (a zipped up copy of xml files). So, it might be a possibility to use a generator like openapi-generator to create that bundle.

docs on building proxies upload proxy bundle api update proxy revision api with new bundle get proxy bundle api

docs on proxy bundle samples list of available bundle samples the sample proxy bundles on github

Contributor guide