Activities are specific types of physical activities that occur during a period of time with a start time and an end time. These activities are often captured automatically using applications that track motion throughout the day, such as Moves, or they are recorded from applications such as Runkeeper or MapMyRun. They can also be manually entered with applications like Fitbit.
Overview
Property | Type | Description |
---|---|---|
code | String | The Code of the resource |
user_code | String | The global Id of the user |
start_time | Datetime with Timezone | The start time of the activity in UTC time |
end_time | Datetime with Timezone | The end time of the activity in UTC time |
timezone | String | The offset from UTC time in +/-hh:mm (e.g. -04:00) |
type | String | The type of activity, such as walking, running, cycling |
source | String | The name of the originating service |
duration | Number | The duration in seconds |
distance | Number | The distance in the specified unit of measure |
steps | Number | The number of steps taken during the activity |
calories | Number | The number of estimated calories burned during the activity |
created_at | Datetime with Timezone | The time the activity was created on the ZivaCare API server |
updated_at | Datetime with Timezone | The time the activity was updated on the ZivaCare API server |
unit | String | The unit of the measurement value. See Unit System. |
Example
GET https://api.zivacare.com/api/v2/human/activities?access_token=demo
{
"activities": [
{
"code": "c6f0f6f8-159e-4d6e-890a-d2b2f4a70d61",
"start_time": "2014-09-16 15:52:01+00",
"end_time": "2014-09-16 15:55:01+00",
"unit": "km",
"type": "jogging",
"source": "fitbit",
"duration": 3,
"distance": 1.1,
"steps": 30,
"calories": 100.00,
"timezone": "Europe/Bucharest",
"user_code": "e231e984-2209-4a10-b634-2257b89c200f",
"created_at": "2015-05-07 11:39:36+00",
"updated_at": "2016-04-20 11:25:02.790469+00"
}
],
"total": 1
}
curl -X POST -H 'Content-Type: application/json' https://api.zivacare.com/api/v2/human/activities?access_token=demo
-d '{ "start_time": "2014-09-16T15:52:01+0000", "end_time": "2014-09-16T15:55:01+0000", "type": "jogging", "duration":3, "distance": 1.1, "steps":30, "calories":100, "time_zone": "Europe/Bucharest", "source": "fitbit", "unit": "km" }'
GET https://api.zivacare.com/api/v2/human/activities/daily/2014-09-16?access_token=demo
{
"activity": [
{
"code": "be096590-81c2-4b13-b431-7ff9a1cb161c",
"start_time": "2014-09-16 15:52:01+00",
"end_time": "2014-09-16 15:55:01+00",
"unit": "km",
"type": "jogging",
"source": "fitbit",
"duration": 3,
"distance": 1.1,
"steps": 30,
"calories": 100.00,
"timezone": "Europe/Bucharest",
"user_code": "e231e984-2209-4a10-b634-2257b89c200f",
"created_at": "2016-05-23 08:58:03.737856+00"
}
],
"total": 1
}
GET https://api.zivacare.com/api/v2/human/activities/period/2014-09-16/2015-09-16?access_token=demo
{
"activities": [
{
"code": "be096590-81c2-4b13-b431-7ff9a1cb161c",
"start_time": "2014-09-16 15:52:01+00",
"end_time": "2014-09-16 15:55:01+00",
"unit": "km",
"type": "jogging",
"source": "fitbit",
"duration": 3,
"distance": 1.1,
"steps": 30,
"calories": 100.00,
"timezone": "Europe/Bucharest",
"user_code": "e231e984-2209-4a10-b634-2257b89c200f",
"created_at": "2016-05-23 08:58:03.737856+00"
}
],
"total": 1
}
GET https://api.zivacare.com/api/v2/human/activities/010170a0-5b9d-4b59-942b-fbea9953ef87?access_token=demo
{
"activity":
{
"code": "010170a0-5b9d-4b59-942b-fbea9953ef87",
"start_time": "2016-02-13 15:44:08+00",
"end_time": "2016-02-13 17:39:10+00",
"unit": "km",
"type": "Walking",
"source": "PEGASO-Runkeeper",
"duration": 6902,
"distance": 11762,
"calories": 1100.00,
"timezone": "Europe/Bucharest",
"user_code": "e231e984-2209-4a10-b634-2257b89c200f",
"created_at": "2016-03-15 17:00:17+00"
}
}
curl -X PUT -H 'Content-Type: application/json' https://api.zivacare.com/api/v2/human/activities/010170a0-5b9d-4b59-942b-fbea9953ef87?access_token=demo
-d '{ "start_time": "2014-09-16T15:52:01+0000", "end_time": "2014-09-16T15:55:01+0000", "type": "jogging", "duration":3, "distance": 1.1, "steps":30, "calories":100, "time_zone": "Europe/Bucharest", "source": "fitbit", "unit": "km" }'