===================== Device Setting ===================== # Device API This API is used to set up the device, send commands, and get some device information/status Mainland China **Host:** https://search.iwown.com Hong Kong, Macau, Taiwan and countries outside of China **Host:** https://euapi.iwown.com General api response format:: { "ReturnCode":0, "Data":{} } ReturnCode: - 0 - Normal - 10001/10505 - there is some error when invoke api - 10002 - Paramters missing or with wrong value/format - 10404 - NO Data 10001/10505/10002 No zero often means you are invoke the api wrongly，if not sure, contact the developer for information. Data field may have or have not, ReturnCode always exist If the device is not activated, accessing the API will not succeed, need add one more param device_model in url to invoke the api, ?device_model=xxx ------------------------------------- Deliver user setting to device ------------------------------------- **URL:** /entservice/cmd/userinfo **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "height":166, "weight":66, "gender":2, "age":66, "calibrate_walk":80, "calibrate_run":80, "calibrate_run":100, "wrist_circle":120, "hypertension":1 } **Note:** - gender - 1 male, 2 female; - calibrate_walk/calibrate_run - unit is cm - wrist_circle: wrist circumference，unit mm，range is 80~230mm optional - hypertension: whether there is history of hypertension 1 - yes, 2 - no optional ----------------------------------- Enable device realtime locate ----------------------------------- **URL:** /entservice/cmd/realtime/location **Method:** POST **Params/json:** :: { "device_id":"984612114945605" } ------------------------------------- Request device data upload ------------------------------------- **URL:** /entservice/cmd/datasync **Method:** POST **Params/json:** :: { "device_id":"984612114945605" } ------------------------------------ Device online/offline status ------------------------------------ **URL:** /entservice/device/status **Method:** GET **Params:** ?device_id={0} device status: - 0-OFFLINE - 1-ONLINE - 2-UNACTIVE - 3-DISABLE - 4-UNACTIVE/NOT EXIST ------------------------------------ Set device fall check option ------------------------------------ **URL:** /entservice/cmd/fallcheck **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "fall_check":true } ------------------------ Set phonebook ------------------------ **URL:** /entservice/phonebook/sync **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "phone_book":[ { "name":"Barry1", "number":"15628457361", "sos":true }, { "name":"Barry2", "number":"18577546507", "sos":true }, { "name":"Barry3", "number":"13662783623", "sos":true }, { "name":"Barry4", "number":"18518931658", "sos":false } ], "forbid":1 } sos - whether the urgent contact, if so, can send sos forbid - optional，1 block strange call, 2 not block strange call name - max 24 bytes number - max 20 bytes set 8 numbers at most ------------------------ clear phonebook ------------------------ **URL:** /entservice/phonebook/clear **Method:** POST **Params/json:** :: { "device_id":"869595060004461" } -------------------------------------- Device data interval setting -------------------------------------- **URL:** /entservice/cmd/datafreq **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "gps_auto_check":true, "gps_interval_time":10, "power_mode":2 } gps_auto_check - locate switch gps_interval_time - locate interval, unit is minute power_mode - optional，Device power saving settings： - 1 - low, power saving; When the watch is placed or in sleep mode, the 4G module will be turned off, data cannot be uploaded, and calls cannot be received. - 2 - mid, power consumption; When the watch is placed, the 4G module will be turned off, data cannot be uploaded, and calls cannot be answered; when the watch enters sleep mode, the 4G module will not be turned off, and data can be uploaded and calls can be answered. - 3 - high, power consumption; When the watch is placed or in sleep mode, the 4G module will not be turned off, and data upload and phone calls will not be affected. ---------------------------------------------------------------------------- Device data uplaod and auto locate interval setting ---------------------------------------------------------------------------- **URL:** /entservice/cmd/locate_dataupload/freq **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "data_auto_upload":true, "data_upload_interval":30, "auto_locate":true, "locate_interval_time":60, "power_mode":2 } data_auto_upload - data timeing upload switch data_upload_interval - data timeing upload interval, unit is minute auto_locate - auto locate switch locate_interval_time - auto locate interval, unit is minute power_mode - optional，Device power saving settings： - 1 - low, power saving; When the watch is placed or in sleep mode, the 4G module will be turned off, data cannot be uploaded, and calls cannot be received. - 2 - mid, power consumption; When the watch is placed, the 4G module will be turned off, data cannot be uploaded, and calls cannot be answered; when the watch enters sleep mode, the 4G module will not be turned off, and data can be uploaded and calls can be answered. - 3 - high, power consumption; When the watch is placed or in sleep mode, the 4G module will not be turned off, and data upload and phone calls will not be affected. ------------------------------- Set wrist turn Light up ------------------------------- **URL:** /entservice/cmd/lcdgesture **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "open":true, "start_hour":0, "end_hour":23 } open - true open, false close start_hour - start hour of lcd gesture, 0 - 23 end_hour - end hour of lcd gesture, 0 - 23 ------------------------ set hr warning ------------------------ **URL:** /entservice/cmd/hralarm **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "open":true, "high":130, "low":50, "threshold":3, "alarm_interval":10 } open - true open hr warning, false close hr warning high - Maximum normal hr low - Minimum normal hr threshold - how may abnormal hr occur，then start warning alarm_interval - interval of warning，unit is minute --------------------------------------- dynamic hr warning setting --------------------------------------- **URL:** /entservice/cmd/dynamic/hralarm **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "open":true, "high":130, "low":50, "timeout":30, "interval":2 } open - true open hr warning, false close hr warning high - Maximum normal hr low - Minimum normal hr timeout - when abnormal hr continue over the duratioin(unit is seconds), start warning interval - interval of warning，unit is minute -------------------------------- Set blood oxygen alarm -------------------------------- **URL:** /entservice/cmd/spo2alarm **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "open":true, "low":80 } open - true open alarm, false close alarm low - Send alarm when bpo below this value ----------------------------------------- blood pressure warning setting ----------------------------------------- **URL:** /entservice/cmd/bpalarm **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "open":true, "sbp_high":120, "sbp_below":80, "dbp_high":120, "dbp_below":80 } open - true open bp alarm, false close bp alarm sbp_high - High pressure maximum value，unit：mmhg sbp_below - High pressure minimum value，unit：mmhg dbp_high - Low pressure maximum value，unit：mmhg dbp_below - Low pressure minimum value，unit：mmhg ----------------------------------- temperature warning setting ----------------------------------- **URL:** /entservice/cmd/temperature/alarm **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "open":true, "high":380, "low":350 } temperatue set as 10 times of your prefer value, e.g. 36.1 set 361 ------------------------ Auto Af setting ------------------------ **URL:** /entservice/cmd/autoaf **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "open":true, "interval":10, "rri_single_time":false, "rri_type":1 } open - true open auto af measure, false close auto af measure interval - auto af measure interval，unit is seconds, the minimum value is 30, the maximum value is 120, if the value set exceeds the range, it will take effect as 60 rri_single_time - optional. If set to true, measure once after each heart rate measurement according to the heart rate interval. If set to false, measure all the time rri_type - optional。default 0， 0:general rri, 1:rri for calculate mood ------------------------ Set Alarm ------------------------ **URL:** /entservice2/clockalarm/set **Method:** POST **Params/json:** :: { "device_id":"869595060004461", "alarms":[ { "repeat":true, "monday":true, "tuesday":true, "wednesday":true, "thursday":true, "friday":true, "saturday":true, "sunday":true, "hour":10, "minute":30, "title":"hehe" } ] } Set up to 5 alarms repeat - true repeat alarm, false one time alarm monday ~ sunday whether open on that day hour/minute: time hour:分钟, 24 hours title: alarm content ------------------------ clear alarm ------------------------ **URL:** /entservice2/clockalarm/clear **Method:** POST **Params/json:** :: { "device_id":"869595060004461" } ------------------------ set sedentary ------------------------ **URL:** /entservice3/sedentary/set **Method:** POST **Params/json:** :: { "device_id":"869595060004461", "sedentaries":[ { "repeat":true, "monday":true, "tuesday":true, "wednesday":true, "thursday":true, "friday":true, "saturday":true, "sunday":true, "start_hour":0, "end_hour":23, "duration":5, "threshold":10 } ] } Set up to 3 sedentary reminders repeat - true repeat alarm, false one time alarm monday ~ sunday whether open on that day start_hour/end_hour: sedentay time range，start hour/end hour 24hours duration: Set the cumulative sitting minutes to a certain number of minutes, the unit is 5 minutes, that is, set 1, which equals 5 minutes threshold: If the number of steps in a minute is less than a certain number, the minute is considered sedentary, and the count is +1. The unit is step, and the default is 40. duration/threshold: Only valid for new devices and new versions ------------------------ clear sedentary ------------------------ **URL:** /entservice3/sedentary/clear **Method:** POST **Params/json:** :: { "device_id":"869595060004461" } ------------------------ Goal setting ------------------------ **URL:** /entservice/cmd/goal **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "step":10000, "distance":10000, "calorie":400 } step - target step distance - target distance,unit is meter calorie - target calorie,unit is kilocalories ------------------------ Reset to factory mode ------------------------ **URL:** /entservice/cmd/factory/reset **Method:** POST **Params/json:** :: { "device_id":"984612114945605" } ------------------------ Set device language ------------------------ **URL:** /entservice/cmd/language/set **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "language":0 } language: - 0 English - 1 Chinese - 2 Italian - 3 Japanese - 4 France - 5 German - 6 Portuguese - 7 Spanish - 8 Russian - 9 Korean - 10 Arabic - 11 Vietnam - 12 Polish - 13 Romanian - 14 Swedish - 15 Thai - 16 Turkish - 17 Denish - 18 Ukrainian - 19 Norwegian - 20 Dutch - 21 Czech - 22 Chinese_Tc - 23 Indonesian ---------------------------- send device message ---------------------------- **URL:** /entservice/cmd/message **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "title":"good news", "description":"Won the lottery, 5 million" } title maximum 15 bytes, description maximum 240 bytes ----------------------------------- Set fall detection sensitivity ----------------------------------- **URL:** /entservice/cmd/fallcheck/sensitivity **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "fall_threshold":20000 } fall_threshold: the sensitivity of fall detection, 14000 by default -------------------------------------------------- Heart rate data measurement interval setting -------------------------------------------------- **URL:** /entservice/cmd/measure/interval/hr **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "interval":10 } interval - unit is minute, minimum 1 minute ----------------------------------------------------------------------------- Other data(except heart rate) measurement interval setting ----------------------------------------------------------------------------- **URL:** /entservice/cmd/measure/interval/other **Method:** POST **Params/json:** :: { "device_id":"984612114945605", "interval":10 } interval - unit is minute, minimum 5 minute ------------------------ Gps Locate ------------------------ **URL:** /entservice/cmd/gps/locate **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "gps_auto_check":true, "gps_interval_time":10, "run_gps":true } Whether the watch is set to perform GPS positioning every time gps_auto_check - locate switch gps_interval_time - locate interval, unit is minute run_gps - whether do gps position every time ------------------------------------------------ Set time format (12/24 hours) ------------------------------------------------ **URL:** /entservice/cmd/timeformat **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "hour_format":1 } set watch to display time as 24 hours or 12 hours hour_format - 0 24hours，1 12hours -------------------------------------- Setting the date format -------------------------------------- **URL:** /entservice/cmd/dateformat **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "date_format":1 } set watch to display date as month/day or day/month date_format - 0 month/day，1 day/month ------------------------------------ Set distance units ------------------------------------ **URL:** /entservice/cmd/distanceunit **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "distance_unit":1 } set watch to display distance with unit metric or imperial distance_unit - 0 metric，1 imperial ------------------------------------ Set temperature units ------------------------------------ **URL:** /entservice/cmd/temperatureunit **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "temperature_unit":1 } set watch to display temperature with unit Celsius or Fahrenheit temperature_unit - 0 Celsius，1 Fahrenheit ------------------------ set wear hand ------------------------ **URL:** /entservice/device/cmd/wearhand **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "right":false } set watch wear hand, left hand or right hand right - false left hand，true right hand ------------------------ set bp calibration ------------------------ **URL:** /entservice/cmd/bpadjust **Method:** POST **Params/json:** :: { "device_id":"866655060067405", "sbp_band":120, "dbp_band":70, "sbp_meter":130, "dbp_meter":80 } sbp_band - sbp measured by watch，dbp_band - dbp measured by watch， sbp_meter - sbp measured by sphygmomanometer，dbp_meter - dbp measured by sphygmomanometer ----------------------------- API authentication ----------------------------- If you apply for API authentication from us, when you call the API to send instructions to your watch, we will check the account information. Only when it is consistent with the account of the customer to whom the device belongs can the instruction be sent to the watch. Otherwise, it will return:: { "ReturnCode": 10403 } The authentication method is to add the account and pwd fields in the Http Header, fill in the account number in account, and fill in the md5 encrypted value of the password in pwd