...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ data: [ { id: 1, description: "", name: "admin", organizationId: "UNC" }, { id: 2, description: "", name: "pod", organizationId: "UNC" } ], statusFact: { success: true } } |
List Facility's Workspaces
Current Implementation
Returns the list of all the Workspaces of a Facility has.
Parameters
Base URL: /organizations/{organizationId}/facilities/{facilityId}/workspaces
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{organizationId} | String | Yes | The id of the Organization. |
{facilityId} | String | Yes | The id of the Facility. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
Happy Path
Code Block | ||||
---|---|---|---|---|
| ||||
{ "data" : [ { "facilityId" : "UNC",
"id" : "unc_adult",
"name" : "Adults"
},
{ "facilityId" : "UNC",
"id" : "unc_nursery",
"name" : "Nursery"
}
],
"statusFact" : { "success" : true }
} |
Read Facility's Workspace
Current Implementation
Returns all the information of a particular Workspace within a Facility.
Parameters
Base URL: /organizations/{organizationId}/facilities/{facilityId}/workspaces/{workspaceId}
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{organizationId} | String | Yes | The id of the Organization. |
{facilityId} | String | Yes | The id of the Facility. |
{workspaceId} | String | Yes | The id of the Workspace. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
Happy Path
Code Block | ||||
---|---|---|---|---|
| ||||
{ "data" : { "facilityId" : "UNC",
"id" : "unc_nursery",
"name" : "Nursery"
},
"statusFact" : { "success" : true }
} |
List Workspace's Rooms
Current Implementation
Returns the list of all the Rooms of a Facility Workspace has.
Parameters
Base URL: /organizations/{organizationId}/facilities/{facilityId}/workspaces/{workspaceId}/rooms
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{organizationId} | String | Yes | The id of the Organization. |
{facilityId} | String | Yes | The id of the Facility. |
{workspaceId} | String | Yes | The id of the Workspace. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
Happy Path
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : [ { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "poda", "name" : "Pod A" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "podb", "name" : "Pod B" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "podc", "name" : "Pod C" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "podd", "name" : "Pod D" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "pode", "name" : "Pod E" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "podf", "name" : "Pod F" }, { "facilityIdworkspaceId" : "UNCunc_nursery", "id" : "podg", "name" : "Pod G" } ], "statusFact" : { "success" : true } } |
Read
...
Workspace's Room
Current Implementation
Returns all the information of a particular room Room within a FacilityWorkspace.
Parameters
Base URL: /organizations/{organizationId}/facilities/{facilityId}/workspaces/{workspaceId}/rooms/{roomId}
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{organizationId} | String | Yes | The id of the Organization. |
{facilityId} | String | Yes | The id of the Facility. |
{workspaceId} | String | Yes | The id of the Workspace. |
{roomId} | String | Yes | The id of the Room. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
Happy Path
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : { "facilityId" : "UNCunc_nursery", "id" : "poda", "name" : "Pod A" }, "statusFact" : { "success" : true } } |
...
http://192.168.1.126:8080/PresentationServices/organizations/UNC/facilities/UNC/workspaces/unc_nursery/rooms/podX?token=c0014590-c367-4117-9f55-94292996e02a&userId=superadmin
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "statusFact" : { "failMessage" : "Error reading Room", "success" : false } } |
User Registration
Current Implementation
This is a POST method. It persists a user in the database with a 'PENDING' status. Users with 'PENDING' status are not allowed to login into the application.
...
Info |
---|
The password and tag id of the created user is hashed using SHA1 algorithm before it is persisted in the database. |
Parameters
Base URL: /users
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
token | String | Yes | Security Token obtained before. |
temporalSession | Boolean | No | DEFAULT: 'false'. Indicates whether the provided token is temporal or not. |
firstName | String | Yes | The name for the new user. |
lastName | String | Yes | The last name for the new user. |
username | String | Yes | The username for the new user. The username must be unique among all the users in the system. |
String | Yes | The email address for the new user. The email must be unique among all the users in the system. | |
password | String | Yes | The password for the new user. At the moment, this is plain text. |
organization | String | Yes | The id of the organization for the new user. |
facility | String | Yes | The id of the facility for the new user. |
role | String | Yes | The id of the role for the new user. |
pin | String | No | The security pin of this user. (This pin is not still being used by the application) |
tagId | String | No | The NFC tag id for the new user. |
API Sample
Happy Path
curl 'http://192.168.0.14:8080/PresentationServices/users' -H 'Accept: application/json, text/javascript, */*; q=0.01' -H 'Origin: file://' -H 'User-Agent: Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36' -H 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8' --data 'firstName=Esteban&lastName=Aliverti&username=eaa&email=esteban.aliverti%40cogmed.com&password=1234&passwordConfirm=1234&organization=UNC&facility=Vidant&role=1&tagId=&token=01b1b134-71e9-4fad-9ca2-45b254e134ab&temporalSession=true' --compressed
...
List possible Users Statuses
Current Implementation
Normally used to fill the 'Status' drop down for a User. It returns the list of all the statuses a User can has.
Parameters
Base URL: /userStatuses
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
curl 'http://192.168.0.14:8080/PresentationServices/userStatuses?userId=sigal&token=8a4804ef-3301-4f89-a5a9-c3fed479d8c3&_=1400057312395' -H 'Accept: application/json, text/javascript, */*; q=0.01' -H 'User-Agent: Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36' --compressed
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : [ { "value" : "ACTIVE" }, { "value" : "PENDING" }, { "value" : "SUSPENDED" }, { "value" : "INACTIVE" } ], "statusFact" : { "success" : true } } |
List Users
Current Implementation
Lists all the users in the application according to a series of filter parameters.
Parameters
Base URL: /users
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
location | ENUM | No | Possible values: ['organization', 'facility']. Specifies whether we want to filter users by Organization or Facility. If this value is not specified the operation will return all the users from all the Organizations. The user invoking the operation in this case MUST have 'list_users_from_all_organizations' permission. |
locationId | String | Yes if location is also specified, otherwise No | The id of the organization or facility we want to use for the filter. |
status | String | No | The id of the user's status we want to use for the filter. |
API Sample
curl 'http://192.168.0.14:8080/PresentationServices/users?location=facility&locationId=UNC&status=ACTIVE&userId=sigal&token=8a4804ef-3301-4f89-a5a9-c3fed479d8c3&_=1400057312400' -H 'Accept: application/json, text/javascript, */*; q=0.01' -H 'User-Agent: Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36' --compressed
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : [ { "email" : "e@e.com", "facilityId" : "UNC", "facilityName" : "UNC", "firstName" : "e", "id" : "354a7aae-ac06-4892-ac61-ce302351eb35", "lastName" : "e", "organizationId" : "UNC", "organizationName" : "UNC", "roleId" : 2, "roleName" : "pod", "status" : "ACTIVE", "username" : "username-e", "updateDate" : "2014-01-06 19:07:40.0", "passwordSet":true, "tagIdSet":true, "pinSet":true }, { "facilityId" : "UNC", "facilityName" : "UNC", "id" : "chargenurse", "organizationId" : "UNC", "organizationName" : "UNC", "roleId" : 1, "roleName" : "admin", "status" : "ACTIVE", "username" : "username-charge", "updateDate" : "2013-03-08 01:20:37.0", "passwordSet":true, "tagIdSet":true, "pinSet":true }, ... ], "statusFact" : { "success" : true } } |
Read User Information
Current Implementation
Returns the information related to a User.
Parameters
Base URL: /users/{requestedUserId}
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{requestedUserId} | String | Yes | The id of the requested user. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
curl 'http://192.168.0.14:8080/PresentationServices/users/354a7aae-ac06-4892-ac61-ce302351eb35?userId=sigal&token=8a4804ef-3301-4f89-a5a9-c3fed479d8c3&_=1400057312409' -H 'Accept: application/json, text/javascript, */*; q=0.01' -H 'User-Agent: Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36' --compressed
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ data: { id: "354a7aae-ac06-4892-ac61-ce302351eb35", lastName: "e", facilityName: "UNC", organizationName: "UNC", status: "ACTIVE", username: "eaa", email: "e@e.com", roleName: "pod", organizationId: "UNC", firstName: "e", facilityId: "UNC", updateDate: "2014-01-06 19:07:40.0", roleId: 2, passwordSet:true, tagIdSet:true, pinSet:true }, statusFact: { success: true } } |
Update User Information
Current Implementation
This is a POST method. Modifies user information such as Status, Name, Last Name, Organization, Role, etc.
...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : [ { "message" : "First name is mandatory" }, { "message" : "Facility is mandatory" } ], "statusFact" : { "failMessage" : "Validation errors found", "success" : false } } |
Parameters
Base URL: /users/{requestedUserId}
Parameters:
...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "data" : { "email" : "e@e.com", "facilityId" : "UNC", "facilityName" : "UNC", "firstName" : "e", "id" : "354a7aae-ac06-4892-ac61-ce302351eb35", "username" : "e", "lastName" : "e", "organizationId" : "UNC", "organizationName" : "UNC", "roleId" : 2, "roleName" : "pod", "status" : "SUSPENDED", "updateDate" : "Wed May 14 13:24:38 CEST 2014", "passwordSet":true, "tagIdSet":true, "pinSet":true }, "statusFact" : { "success" : true } } |
Delete User
Current Implementation
This is a DELETE method. Modifies user status to INACTIVE.
The final result is the same as using the Update User Information operation using INACTIVE as the new status.
Parameters
Base URL: /users/{requestedUserId}
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{requestedUserId} | String | Yes | The id of the requested user. |
token | String | Yes | Security Token obtained before. |
userId | String | Yes | The id of the logged in user. |
API Sample
curl -X DELETE 'http://192.168.2.103:8080/PresentationServices/users/354a7aae-ac06-4892-ac61-ce302351eb35' -H 'Accept: application/json, text/javascript, */*; q=0.01' -H 'Origin: file://' -H 'User-Agent: Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36' -H 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8' --compressed
...
Check User's Attribute Availability
Current Implementation
This operation can be used to check whether a specific value for a specific attribute of a User is already taken by any other user.
...
In the cases where the specified attribute is not available, the result will contain a field called 'takenBy' which will contains the userId of the user having it.
Parameters
Base URL: /userAttributeAvailable/{attribute}
Parameters:
Name | Type | Mandatory | Description |
---|---|---|---|
{attribute} | ENUM | Yes | Possible values: ['tagId', 'email', 'username', 'pin']. The User's attribute we want to check. |
token | String | Yes | Security Token obtained before. |
userId | String | Only if 'token' is not a temporal token | The id of the logged in user. |
temporalSession | Boolean | No | DEFAULT: 'false'. Indicates whether the provided token is temporal or not. |
value | String | Yes | The value that we want to check. |
API Sample
Available attribute (email)
...