Hello,

Most API Gateways advertise themselves as API Lifecycle Management
products. In that regard, Apache APISIX is lacking. My use-case is quite
straightforward.

The company has front-end and back-end developers. With the help of the
business, they agree on an OpenAPI spec. Then, they go on developing their
part. As a frontend developer, I want to be able to develop independently
from the backend part. For this reason, a couple of mock servers have
popped up: you feed them with the OpenAPI spec, and they serve the data in
the example section of the spec.

Apache APISIX has two ways to mock data:

   1. The mocking <https://apisix.apache.org/docs/apisix/plugins/mocking/>
   plugin. It's unrelated to OpenAPI, you need to mock everything by hand
   2. Import the spec
   <https://apisix.apache.org/docs/dashboard/IMPORT_OPENAPI_USER_GUIDE/>
   from the APISIX dashboard. You need additional extensions in the spec, it's
   one shot (there's no continuous change management) and it doesn't mock
   anything.

I'd like to propose a way for Apache APISIX to:

   - Manage an OpenAPI spec
   - By default, serve the example section in the spec
   - Be able to replace the example by real upstream
   - Dynamically mirror the changes in the spec file

Please let me know if you think it's a worthy feature.

Nicolas

Reply via email to