REST API for OpenMRS

The module exposes the OpenMRS API as REST web services. If an OpenMRS instance is running the webservice.rest module, other applications can retrieve and post certain information to an OpenMRS database.

If you are not a developer, or just want to install the REST Web Services module into your system, visit the module download page instead.

The required OpenMRS version to run the REST Web Services Module is 1.8.4+ or 1.9.0+

To build the module from source, clone this repo:

git clone https://github.com/openmrs/openmrs-module-webservices.rest

Then navigate into the openmrs-module-webservices.rest directory and compile the module using Maven:

cd openmrs-module-webservices.rest && mvn clean install

📌 You will need Maven and Java 8 installed to successfully build and run the tests.

The API documentation is available inside the OpenMRS application and is linked to from the advanced administration screen. The URL should be something like:

http://localhost:8080/openmrs/module/webservices/rest/apiDocs.htm

• Quick java swing client that displays patients and encounters: http://svn.openmrs.org/openmrs-contrib/examples/webservices/hackyswingexample/
• You can download a client java application that allows add/edit a person (any resource) by making a query to the webservices.rest module - https://project-development-software-victor-aravena.googlecode.com/svn/trunk/ClientOpenMRSRest/

The OpenMRS API documentation is built automatically using Swagger UI. For details on how to customize the documentation see the swagger-ui branch in the openmrs-contrib-apidocs repo.

MPL-2.0 w/ HD