Question YAML/OpenAPI file generation.

JamesBowen

JamesBowen

19+ years progress programming and still learning.
OpenEdge 11.7.25

I'm creating a RESTFul API using the PASOE architecture and I have been requested to provide a YAML file. I can't seem to find a method of automatically generating a YAML file from Developer Studio.

Progress' KBase talks about enabling the SWAGGER Editor for the OEManager, but it seems that is can't be used for any developed REST APIs.

What is the solution apart from manually hand crafting a YAML file based on the OpenAPI standards?
 
Our REST APIs are based on our entity definitions, we generate OpenAPI docs "manually" based on these definitions. We serve either the json file or present it in the Swagger editor.

Tip: as starting point create an OpenAPI JSON doc. Transforming this to YAML (if you really need it) is trivial (versus the other way round). The SmartBear Swagger Editor can transform both ways.
 
I'm reopening this thread, because I though I saw a presentation about new features of 12.8 that it can now create YAML files.
Only issue is that I can't remember where I saw this presentation (either as powerpoint or youtube).

Can anyone confirm that 12.8 now supports the creation of YAML files from PASOE REST transports?
 
JamesBowen said:
Can anyone confirm that 12.8 now supports the creation of YAML files from PASOE REST transports?
Click to expand...
Does not ring any bell.

Since Progress have been calling REST transport a dead end for years, use WEB transport, I doubt that they will have invested in enhancements for REST transport.
 
You must log in or register to reply here.
Back
Top