Module:OpenAPI

Contents 1 Introduction 2 API Generation 2.1 Defining the API 2.1.1 Setting the Openbravo server 2.2 Deploying the API 2.3 Visualizing the API

Introduction

This module allows to integrate in Openbravo APIs documented using the OpenAPI specification. It also provides the ability to visualize and interact with those APIs through Swagger-UI.

API Generation

Defining the API

The steps to define an API are:

1. Create a yaml file (.yml) file following the OpenAPI specification. See here for a detailed explanation of how to create the file.
2. Place that file under a folder named api of your module.

See an API definition example here.

Setting the Openbravo server

One of the configuration properties of the OpenAPI specification file is the server which provides connectivity information to a target server that allows to interact with the API.

The OpenAPI module makes it possible to configure this property dynamically, so that it is set with the value of the context.url property of the Openbravo.properties file. This way we will be able to interact with the API using the Openbravo server itself. To define this setting in such way, the ${contextURL} placeholder should be used:

...
servers:
- url: ${contextURL}
...

That placeholder will be replaced with the context.url when deploying the API.

Deploying the API

The APIs are deployed at compile time. To deploy them, the following steps should be done:

1. Move to the sourcepath/modules/org.openbravo.service.openapi module
2. Run ant compile.api
3. Go back to the sourcepath folder
4. Run ant smartbuild

Visualizing the API

Once the APIs have been deployed, they can be visualized at the following URL:

http(s)://<openbravo_url>/api

A live example is available here.