Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

See REST Web Services User Guide for more information.Enhanced Web Services (Design Page)

Downloads

View Source: http://source.openmrs.org/browse/Modules/webservices.rest/trunk/
Checkout Source: http://svn.openmrs.org/openmrs-modules/webservices.rest/trunk/
Download: http://modules.openmrs.org/modules/view.jsp?module= (To be updated once module is formally released)

Required OpenMRS Versions

For all features in the REST module to work you must use a nightly build of at least version 20404. This is due to

Jira Legacy
TRUNK-2323
TRUNK-2323
serverOpenMRS JIRA
and
Jira Legacy
TRUNK-2324
TRUNK-2324
serverOpenMRS JIRA

The REST Web Services module requires at least OpenMRS 1.9.0, 1.8.1, 1.7.2, or 1.6.3 to run.

Development Plans

Development sprint: 2011-05-16 Development Sprint

Alpha release of module coming soon.

Release Notes

( To be filled in once a formal release is made to the Module Repository )

Module Configuration

webservices.rest.maxResultsDefault - This Global Property determines the maximum number of resources that can be accessed on any webservice call.  The default is 50

webservices.rest.maxResultsAbsolute - This Global Property determines the absolute maximum number of resources that can be accessed on any webservice call. If the client requests more than this limit, then receives an error. The default is 1000.

webservices.rest.uriPrefix - This should point at the root of your exposed web application.  This is typically _http://localhost:8080/openmrs_ during testing, but after being deployed will be something like _http://192.168.1.100/openmrs_ or _http://yourdomainname.org/openmrs_.  If this is empty or not filled in, the user will see NEEDSTOBECONFIGURED/ws/rest/ as the "self" urls on all objects. 

webservices.rest.allowedips - By default this is "", which means anyone can access the rest URLs. If you put any IP addresses into this list, only calls from those are allowed. IPs should be separated by a whitespace or a comma. IPs can be declared with bit masks to denote whole subdomains e.g. 10.0.0.0/30 matches 10.0.0.0 - 10.0.0.3 and 10.0.0.0/24 matches 10.0.0.0 - 10.0.0.255. Non matching IP addresses will receive a 403 HTTP error. Both IPv4 and IPv6 addresses are supported.

Technical Documentation

This module uses Spring 3 annotations to expose URLs.  Primary transport language is currently JSON.

...

From the 304 Not Modified, we know that the records are the same and the client doesn't have to get the data again.

Downloads

View Source: http://source.openmrs.org/browse/Modules/webservices.rest/trunk/
Checkout Source: http://svn.openmrs.org/openmrs-modules/webservices.rest/trunk/
Download: http://modules.openmrs.org/modules/view.jsp?module= (To be updated once module is formally released)

Required OpenMRS Versions

...

The REST Web Services module requires at least OpenMRS 1.9.0, 1.8.1, 1.7.2, or 1.6.3 to run.

Development Plans

Development sprint: 2011-05-16 Development Sprint

Alpha release of module coming soon.

Release Notes

( To be filled in once a formal release is made to the Module Repository )

Module Configuration

webservices.rest.maxResultsDefault - This Global Property determines the maximum number of resources that can be accessed on any webservice call.  The default is 50

webservices.rest.maxResultsAbsolute - This Global Property determines the absolute maximum number of resources that can be accessed on any webservice call. If the client requests more than this limit, then receives an error. The default is 1000.

webservices.rest.uriPrefix - This should point at the root of your exposed web application.  This is typically _http://localhost:8080/openmrs_ during testing, but after being deployed will be something like _http://192.168.1.100/openmrs_ or _http://yourdomainname.org/openmrs_.  If this is empty or not filled in, the user will see NEEDSTOBECONFIGURED/ws/rest/ as the "self" urls on all objects. 

webservices.rest.allowedips - By default this is "", which means anyone can access the rest URLs. If you put any IP addresses into this list, only calls from those are allowed. IPs should be separated by a whitespace or a comma. IPs can be declared with bit masks to denote whole subdomains e.g. 10.0.0.0/30 matches 10.0.0.0 - 10.0.0.3 and 10.0.0.0/24 matches 10.0.0.0 - 10.0.0.255. Non matching IP addresses will receive a 403 HTTP error. Both IPv4 and IPv6 addresses are supported.