As explained in the Primer for back-end development there are various supporting libraries which can be utilised to ease development with OpenAPI.

FOLIO currently uses OpenAPI (OAS) version 3.0

Use “api-lint” to assess API descriptions, schema, and examples. A script is provided, to find files and run it. That script can be run locally, and is also utilised by the continuous-integration.

Describe schema and properties.

Use “api-doc” to generate documentation from the API descriptions, schema, and examples. That script can be run locally, and is also utilised by the continuous-integration to build the FOLIO API documentation and the associated list of endpoints.

Investigate the other OpenAPI-using server-side modules.

Reference API documentation is automatically generated by the continuous integration, for modules that are managed with the FOLIO CI.