HTTP REST Data retrieval - Medisana/vitadock-api GitHub Wiki

Action Token Resource Return
Data retrieval

GET Request

Application/Device Token
Access Token

(signed with Application/Device Secret, Access Secret)
https://cloud.vitadock.com/data/[module name]?start=[first entry number]&max=[max number of returned elements]&date_since=[return entries younger than this date]

(default values for max is 100 and for date_since is 0, i.e. both fields are optional but they still have to be included in the signature. "start" is also optional but will not be included in the calculation of the signature when not defined.)

Headers: "Accept=application/json"
[{"@ ":"", ..., ":"", ...}]

(the entries are ordered by measurement_date, newest first [if start parameter is given: oldest first]
Data synchronization

GET request
Application/Device Token
Access Token


(signed with Application/Device Secret, Access Secret)
https://cloud.vitadock.com/data/[module name]/sync?start=[first entry number]&max=[max number of returned elements]&date_since=[return entries younger than this date]

(default values for max is 100 and for date_since is 0, i.e. all fields are optional but they still have to be included in the signature. "start" is also optional but will not be included in the calculation of the signature when not defined.)

Headers: "Accept=application/json"
[{"@":"", ..., ":"", ...}]

(the entries are ordered by updated_date, newest first [if start parameter is given: oldest first])
Data count

GET request
Application/Device Token
Access Token


(signed with Application/Device Secret, Access Secret)
https://cloud.vitadock.com/data/[module name]/count?date_since=[return entries younger than this date]

(default value for date_since is 0, i.e. the field is optional but it still has to be included in the signature!)
[integer], e.g. "3"

Please note:

  • module name is one of the following: "cardiodocks", "glucodockglucoses", "glucodockinsulins", "glucodockmeals", "targetscales", "thermodocks", "tracker/stats", "tracker/activity", "tracker/sleep"
  • max: To receive all data since a certain entry multiple accesses might be needed
  • date for Data retrieval refers to the measurement date (i.e. client time)
  • Date for Data count and Data synchronization refers to creation date (i.e. server time)
  • Format of returning field names does not contain underscores (i.e. e.g. "activityStatus" instead of "activity_status", "createdDate" instead of "created_date" etc.)
⚠️ **GitHub.com Fallback** ⚠️