{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This module will not be the preferred REST web service module.","type":"text"}]},{"type":"paragraph","content":[{"text":"For a more complete list of web service methods see this module's replacement: ","type":"text"},{"text":"Webservices.rest Module","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25521085"}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"What This Module Does Do","type":"text"}]},{"type":"paragraph","content":[{"text":"The OpenMRS REST Module provides a limited mechanism for communicating with an OpenMRS system externally as a client via Web Services. In this case, the REST Module is implemented using REST (","type":"text"},{"text":"1","type":"text","marks":[{"type":"link","attrs":{"href":"http://en.wikipedia.org/wiki/Representational_State_Transfer"}}]},{"text":").","type":"text"}]},{"type":"paragraph","content":[{"text":"The methods or functions currently exposed via the OpenMRS REST Module are as follows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient - get 1 or more patients by patient identifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"findPatient - get 1 or more patients by patient name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Observations - get a list of observation by submitting the patient identifier and concept id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Submitting an hl7 message - send the hl7 source name and hl7 message string via the HTTP PUT method","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User - get a user by user identifier or name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"findUser - get 1 or more patients by user roles, identifier and/or name","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"What This Module Does Not Do","type":"text"}]},{"type":"paragraph","content":[{"text":"Here's some caveats to usage of the REST Module:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REST is not SOAP - If you need SOAP, you'll need to write a SOAP layer on top of this module, or convert your SOAP calls to REST in your client","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The entire OpenMRS API is not exposed here -- hopefully more of the API is exposed as time goes on","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Calls to the API are not Audited (as far as I can tell)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Access URLs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/findPatient/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/json/findPatient/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/patient","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/json/patient","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/hl7","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/obs?pId=patientIdentifier&cId=conceptId","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/json/obs?pId=patientIdentifier&cId=conceptId","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/user/identifierOrName","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/json/user/identifierOrName","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/api/findUser/identifierOrName?role=RoleName&role=OtherRoleName","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/moduleServlet/restmodule/json/findUser/identifierOrName?role=RoleName&role=OtherRoleName","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example Usage","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"All example URL paths are assumed to start with: ","type":"text"},{"text":"http://myhost:myport/openmrs/moduleServlet/restmodule","type":"text","marks":[{"type":"link","attrs":{"href":"http://myhostmyport"}},{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"Example #1:","type":"text","marks":[{"type":"strong"}]},{"text":" Search for patients matching a search criteria","type":"text"}]},{"type":"paragraph","content":[{"text":"This call would do a Patient Query based on the search string \"John Smith\". A list of patients matching that search criteria would be returned.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/api/findPatient/John+Smith","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n 100-8\n asdf\n 100\n \n \n pre\n test123\n middle\n test\n test2\n deg\n \n \n

\n 555 Johnson Rd.\n Apt. 555\n Indianapolis\n IN\n USA\n

\n asdf\n \n \n \n \n

\n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/json/findPatient/John","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"birthdate\": \"1975-01-01\",\n \"birthdateEstimated\": \"false\",\n \"gender\": \"M\",\n \"identifierList\": [\n {\n \"preferred\": \"1\",\n \"type\": \"OpenMRS Identification Number\",\n \"identifier\": \"100-8\"\n },\n {\n \"type\": \"Old Identification Number\",\n \"identifier\": \"asdf\"\n },\n {\n \"type\": \"Old Identification Number\",\n \"identifier\": \"100\"\n },\n \\\n ],\n \"name\": {\n \"prefix\": \"pre\",\n \"givenName\": \"test123\",\n \"middleName\": \"middle\",\n \"familyName\": \"test\",\n \"familyName2\": \"test2\",\n \"degree\": \"deg\",\n\n },\n \"addressList\": [\n {\n \"preferred\": \"1\",\n \"address1\": \"555 Johnson Rd.\",\n \"address2\": \"Apt. 555\",\n \"cityVillage\": \"Indianapolis\",\n \"stateProvince\": \"IN\",\n \"country\": \"USA\",\n\n },\n {\n \"preferred\": \"1\",\n \"address1\": \"asdf\",\n\n },\n\n ]\n }\n]\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Example #2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This call does a Patient Lookup based on the OpenMRS Identifier \"OpenMRS Identification Number\". In this case, the Patient with the ID Number of \"100-3\" would be returned.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/api/patient/100-3","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n 100-8\n asdf\n 100\n \n \n pre\n test123\n middle\n test\n test2\n deg\n \n \n

\n 555 Johnson Rd.\n Apt. 555\n Indianapolis\n IN\n USA\n

\n asdf\n \n \n \n \n

\n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/json/patient/100-3","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"birthdate\": \"1975-01-01\",\n \"birthdateEstimated\": \"false\",\n \"gender\": \"M\",\n \"identifierList\": [\n {\n \"preferred\": \"1\",\n \"type\": \"OpenMRS Identification Number\",\n \"identifier\": \"100-8\"\n },\n {\n \"type\": \"Old Identification Number\",\n \"identifier\": \"asdf\"\n },\n {\n \"type\": \"Old Identification Number\",\n \"identifier\": \"100\"\n },\n\n ],\n \"name\": {\n \"prefix\": \"pre\",\n \"givenName\": \"test123\",\n \"middleName\": \"middle\",\n \"familyName\": \"test\",\n \"familyName2\": \"test2\",\n \"degree\": \"deg\",\n\n },\n \"addressList\": [\n {\n \"preferred\": \"1\",\n \"address1\": \"555 Johnson Rd.\",\n \"address2\": \"Apt. 555\",\n \"cityVillage\": \"Indianapolis\",\n \"stateProvince\": \"IN\",\n \"country\": \"USA\",\n\n },\n {\n \"preferred\": \"1\",\n \"address1\": \"asdf\",\n\n },\n\n ]\n }\n]\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Example #3:","type":"text","marks":[{"type":"strong"}]},{"text":" Request for a list of observations for a given patient and concept","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/api/obs?pId=100&cId=5090","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n HEIGHT (CM)\n 183.0\n \n Too tall\n \n \n \n HEIGHT (CM)\n 200.0\n \n Too obese\n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/json/obs?pId=100&cId=5090","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"isObsGrouping\": false,\n \"patientId\": 3,\n \"concept\": {\n \"id\": 5090,\n \"name\": \"HEIGHT (CM)\"\n },\n \"location\": {\n \"id\": 1\n },\n \"obsDatetime\": \"2010-02-15\",\n \"valueNumeric\": 183,\n \"isComplex\": false,\n \"encounter\": {\n \"id\": 1,\n \"type\": \"ADULTINITIAL\"\n },\n \"uuid\": \"1b6898bf-bc11-4b79-9f30-8a3c0c4dd10a\",\n \"comment\": \"Too tall\"\n },\n {\n \"isObsGrouping\": false,\n \"patientId\": 3,\n \"concept\": {\n \"id\": 5090,\n \"name\": \"HEIGHT (CM)\"\n },\n \"location\": {\n \"id\": 1\n },\n \"obsDatetime\": \"2010-02-15\",\n \"valueNumeric\": 200,\n \"isComplex\": false,\n \"encounter\": {\n \"id\": 1,\n \"type\": \"ADULTINITIAL\"\n },\n \"uuid\": \"1b6808bf-bc17-4b98-9f30-8a3c0c4dd10t\",\n \"comment\": \"Too obese\"\n }\n]\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" The parameters at the end of the request URL i.e pId and cId are patientId and conceptId respectively. If you wish to view the JSON output in your browser, you will need to install a json viewer plugin for your respective browser if it exists, otherwise you will be prompted to save the file.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example #4:","type":"text","marks":[{"type":"strong"}]},{"text":" Sending an hl7 message using rest","type":"text"}]},{"type":"paragraph","content":[{"text":"http://myhost:serverport/openmrs/moduleServlet/restmodule/api/hl7?message=my_hl7_message_string&source=myHl7SourceName","type":"text","marks":[{"type":"link","attrs":{"href":"http://myhostserverport"}}]}]},{"type":"paragraph","content":[{"text":"Example #5:","type":"text","marks":[{"type":"strong"}]},{"text":" Getting a patient based on the user identifier","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/api/user/1","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n Super\n \n User\n \n \n System Developer\n Provider\n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"/json/user/4","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"addressList\": [],\n \"userId\": \"4\",\n \"systemId\": \"4-2\",\n \"username\": \"ajanthan\",\n \"gender\": \"M\",\n \"uuid\": \"c6ef8bd8-fd7e-11df-8272-0800271bba91\",\n \"name\": {\n \"givenName\": \"aja\",\n \"familyName\": \"bala\"\n },\n \"roleList\": [\n \"System Developer\",\n \"Provider\"\n ]\n }\n]\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Resources","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View REST module source","type":"text","marks":[{"type":"link","attrs":{"href":"http://source.openmrs.org/browse/Modules/restmodule"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download REST module","type":"text","marks":[{"type":"link","attrs":{"href":"https://dev.openmrs.org/modules/view.jsp?module=restmodule"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tidbits","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Calls to the REST library are restricted by the IP source address of the calling client. By default, this IP list is limited to calls from ","type":"text"},{"text":"localhost","type":"text","marks":[{"type":"em"}]},{"text":" (127.0.0.1). If you want to modify this list to allow other clients to call the REST layer, simply update the appropriate property in the setting (formerly global_property 1.8 and below) table in the database.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Passing connection credentials: ...","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Release Notes","type":"text"}]},{"type":"paragraph","content":[{"text":"1.4.4.2","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added findUser to find users by role, name and/or id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cleaned up rendering process","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4.4.1","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added ability to fetch users by id - TRUNK-351","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clarified some of the hl7 message fetch errors","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4.4","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URLs no longer need to have a trailing backslash","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixes to other minor bugs","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4.3","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"changed found identifiers for patients to only include active (non-voided) identifiers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4.2","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added ability to receive and process hl7 messages in a restful way","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4.1","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed error during authentication when the username or password isn't provided","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.4","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added support for Obs(Observations) fetching.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Version numbers have been added to the xml ouput for both patients and obs.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.3.3","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed json for patients without any addresses","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.3.1/1.3.2","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed json for multiple patients","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Removed trailing commas from json","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.3","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added json functionality for patient searching","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"1.2.3","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed module for v1.5 of OpenMRS","type":"text"}]}]}]}],"version":1}

Browser not supported