/webstore-api

Icreated WebStore API plugin for ERP iDempiere

Primary LanguageJava

∫ created

Integration created Donate

WebStore API plugin for ERP Idempiere

Attention: The full information about the project can be found on the project website.

This server side plugin is created to show how API REST can be used in OSGI Idempiere Environment.

It's based on Jersey API Framework, Java-JWT for security purposes & Swagger integration:

WebStore Schema

This API provides following services:

Swagger services

It's quite enough to build a real frontend commercial site with. As an example you can check an Angular project built on it: https://github.com/icreated/webstore

Installing / Getting started

To build this plugin you need to get sources in your project directory:

git clone https://github.com/icreated/webstore-api.git

Important! Edit pom.xml to link native Idempiere libraries with parent project. If you put sources directly in Idempiere sources folder, it will be

<relativePath>../org.idempiere.parent/pom.xml</relativePath>

like others Idempiere plugins, otherwise modify it.

Build it with Maven:

mvn install

It works? If it's ok, then you are using Idempiere 7.

Otherwise, make sure you have all Jersey dependencies. Important to outline that Idempiere (version 6.2) already contains some libraries from Jersey.

You can download missing dependencies manually from https://mvnrepository.com/. Check the version. In my case it was 2.22.1

Just in case here are my Jersey dependencies, I hope this helps you:

Jersey Dependencies

Deploying / Publishing / Testing

Check if plugin is working by getting OpenAPI description file:

http://localhost:8080/services/api-docs/openapi.xml

To check and test REST services install Swagger plugin from here:

https://github.com/icreated/swagger

Make sure that Swagger plugin points to http://localhost:8080/services/api-docs/openapi.xml

Contributing

If you'd like to contribute, please fork the repository and use a feature branch.

Pull requests are warmly welcome

Licensing

GNU General Public License