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