REST API version 1: Difference between revisions
Jump to navigation
Jump to search
(Created page with "LifeGuide provides a REST API to manage parts of an intervention. This API is a work-in-progress and so will not be complete. __TOC__ = Intervention Users (participants) = ...") |
(Added Intervention User Data) |
||
Line 26: | Line 26: | ||
Transfer-Encoding: chunked | Transfer-Encoding: chunked | ||
[{"id":1,"enabled":true,"username":" | [{ "id": 1, "enabled": true, "username": "username1", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/1"}, | ||
{"id":2,"enabled":true,"username":" | { "id": 2, "enabled": true, "username": "username2", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/2"}, | ||
{"id":3,"enabled":true,"username":" | { "id": 3, "enabled": true, "username": "username3", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/3"}, | ||
{"id":4,"enabled":true,"username":" | { "id": 4, "enabled": true, "username": "username4", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/4"}, | ||
{"id":5,"enabled":true,"username":" | { "id": 5, "enabled": true, "username": "username5", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/5"}] | ||
</pre> | </pre> | ||
Line 73: | Line 73: | ||
Content-Type: text/html;charset=utf-8 | Content-Type: text/html;charset=utf-8 | ||
Content-Length: 0 | Content-Length: 0 | ||
</pre> | |||
= Intervention User Data = | |||
== List Intervention User Data == | |||
Example cURL command: | |||
<pre> | |||
curl -i -X GET \ | |||
--header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ | |||
"https://beta.lifeguideonline.org/api/v1/intervention_user/2/data" | |||
</pre> | |||
Example response: | |||
<pre> | |||
HTTP/1.1 200 OK | |||
Date: Mon, 01 Jan 2018 00:00:00 GMT | |||
Server: Apache-Coyote/1.1 | |||
Content-Type: application/json;charset=utf-8 | |||
Transfer-Encoding: chunked | |||
{ | |||
"variable1": "value1", | |||
"variable2": "value2", | |||
"variable3": "value3", | |||
"variable4": 4, | |||
"variable5": 5, | |||
"variable6": 6 | |||
} | |||
</pre> | |||
== Read Intervention User Data == | |||
Example cURL command: | |||
<pre> | |||
curl -i -X GET \ | |||
--header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ | |||
"https://beta.lifeguideonline.org/api/v1/intervention_user/2/data/variable1" | |||
</pre> | |||
Example response: | |||
<pre> | |||
HTTP/1.1 200 OK | |||
Date: Mon, 01 Jan 2018 00:00:00 GMT | |||
Server: Apache-Coyote/1.1 | |||
Content-Type: application/json;charset=utf-8 | |||
Transfer-Encoding: chunked | |||
{ | |||
"variable1": "value1" | |||
} | |||
</pre> | </pre> |
Revision as of 12:05, 31 May 2018
LifeGuide provides a REST API to manage parts of an intervention. This API is a work-in-progress and so will not be complete.
Intervention Users (participants)
List Intervention Users
Example cURL command:
curl -i -X GET \ --header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ "https://beta.lifeguideonline.org/api/v1/intervention_user?per_page=5"
Example response:
HTTP/1.1 200 OK Date: Mon, 01 Jan 2018 00:00:00 GMT Server: Apache-Coyote/1.1 X-Total: 13 Link: <https://beta.lifeguideonline.org/api/v1/intervention_user?page=2&per_page=5>; rel="next" Content-Type: application/json;charset=utf-8 Transfer-Encoding: chunked [{ "id": 1, "enabled": true, "username": "username1", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/1"}, { "id": 2, "enabled": true, "username": "username2", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/2"}, { "id": 3, "enabled": true, "username": "username3", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/3"}, { "id": 4, "enabled": true, "username": "username4", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/4"}, { "id": 5, "enabled": true, "username": "username5", "uri": "https://beta.lifeguideonline.org/api/v1/intervention_user/5"}]
Create an Intervention User
Example cURL command:
curl -i -X POST \ --header "Content-Type: application/json" \ --header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ --data '{"username"="john.smith","password"="123456"}' \ "https://beta.lifeguideonline.org/api/v1/intervention_user"
Example response:
HTTP/1.1 201 Created Date: Mon, 01 Jan 2018 00:00:00 GMT Server: Apache-Coyote/1.1 Content-Location: https://beta.lifeguideonline.org/api/v1/intervention_user/20 Content-Type: text/html;charset=utf-8 Transfer-Encoding: chunked
Delete an Intervention User
Example cURL command:
curl -i -X DELETE \ --header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ "https://beta.lifeguideonline.org/api/v1/intervention_user/20"
Example response:
HTTP/1.1 204 No Content Date: Mon, 01 Jan 2018 00:00:00 GMT Server: Apache-Coyote/1.1 Content-Type: text/html;charset=utf-8 Content-Length: 0
Intervention User Data
List Intervention User Data
Example cURL command:
curl -i -X GET \ --header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ "https://beta.lifeguideonline.org/api/v1/intervention_user/2/data"
Example response:
HTTP/1.1 200 OK Date: Mon, 01 Jan 2018 00:00:00 GMT Server: Apache-Coyote/1.1 Content-Type: application/json;charset=utf-8 Transfer-Encoding: chunked { "variable1": "value1", "variable2": "value2", "variable3": "value3", "variable4": 4, "variable5": 5, "variable6": 6 }
Read Intervention User Data
Example cURL command:
curl -i -X GET \ --header "Authorization: Token cOrNDlXtHTH17lFYUF5ixo8e5w7myXxM" \ "https://beta.lifeguideonline.org/api/v1/intervention_user/2/data/variable1"
Example response:
HTTP/1.1 200 OK Date: Mon, 01 Jan 2018 00:00:00 GMT Server: Apache-Coyote/1.1 Content-Type: application/json;charset=utf-8 Transfer-Encoding: chunked { "variable1": "value1" }