简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

体脂秤

更新时间:2021-07-30 04:03:17下载pdf

API 列表

action 描述
scales.analysis-reports 计算体脂报告
scales.historyData 获取体脂秤称重记录
scales.userData 认领体脂秤称重数据
scales.deleteData 删除体脂秤称重数据
scales.deleteUserData 删除用户的称重数据
scales.userTrendDatas 获取用户趋势数据(默认显示当前周)

计算体脂报告

接口说明

计算体脂报告

接口地址

action: scales.analysis-reports

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
height Double 身高(单位:cm)
weight Double 体重 (单位:kg)
age Integer 年龄
sex Integer 性别(1-男 2-女)
resistance String 体脂秤电阻

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Object 返回结果

result参数说明

参数名 类型 说明
body_type Integer 身型(0-过轻 1-正常 2-过重 3-肥胖 4-非常肥胖 )
weight Double 体重
ffm String 去脂体重
water String 水分
body_score String 身体得分
bones String 骨量
muscle String 肌肉量
protein String 蛋白质
fat String 体脂
metabolism String 基础代谢
visceral_fat String 内脏脂肪等级
body_age String 身体年龄
bmi String BMI

请求示例

{ "action": "scales.analysis-reports", "params": { "device_id": "vdevo158452200194602", "height":178, "weight":78.3, "resistance":"718", "age":26, "sex":1 } }

响应示例

{ "success": true, "t": 1540955256215, "result": { "body_type":2, "weight":78.3, "ffm":"58.3", "water":"51.4", "body_score":"82.1", "bones":"3.6", "muscle":"54.9", "protein":"18.5", "fat":"25.5", "body_age":"29", "metabolism":"1778", "visceral_fat":"9.3", "bmi":"27.1" } }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法
1109 参数非法

获取体脂秤称重记录

接口说明

获取体脂秤称重记录

接口地址

action: scales.historyData

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
page_no Integer 分页数
page_size Integer 页码
user_id String 用户ID
start_time Long 开始时间(13位时间戳)
end_time Long 结束时间(13位时间戳)

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Object 返回的分页对象

result参数说明

参数名 参数类型 说明
total Integer 分页总数
records List 记录数

records参数说明

参数名 参数类型 说明
device_id String 设备ID
id String 数据ID
user_id String 关联的用户ID
nick_name String 关联用户的名称
create_time Long 创建时间
weight Double 体重(kg)
height Double 身高(cm)

请求示例

{ "action": "scales.historyData", "params": { "device_id": "vdevo158452200194602", "page_no": 1, "page_size": 10, "user_id": "ay1578921339405Lr3au", "start_time": 1584515608, "end_time": 1585194008 } }

响应示例

{ "success":true, "t":1573441137, "result":{ "total":2, "records":[ { "device_id":"xxx", "id":"0020y", "user_id":"00234", "nick_name":"yangyc", "create_time":1573441137 }, { "device_id":"xxx", "id":"0020z", "user_id":"00233", "nick_name":"yangyc2", "create_time":1573441137 } ] } }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法

认领体脂秤称重数据

接口说明

认领体脂秤称重数据

接口地址

action: scales.userData

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
user_id String 添加的用户ID
id String 数据ID

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Boolean 请求结果

请求示例

{ "action": "scales.userData", "params": { "device_id": "vdevo158452200194602", "user_id": "97", "id": "xxxx0001" } }

响应示例

{ "success":true, "t":1573441137, "result":true }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法

删除体脂秤称重记录

接口说明

删除体脂秤称重记录

接口地址

action: scales.deleteData

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
id String 数据ID

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Boolean 请求结果

请求示例

{ "action": "scales.deleteData", "params": { "device_id": "vdevo158452200194602", "id": "xxxx0001" } }

响应示例

{ "success":true, "t":1573441137, "result":true }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法

删除用户的称重记录

接口说明

删除用户的称重记录

接口地址

action: scales.deleteUserData

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
user_id String 用户ID

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Boolean 请求结果

请求示例

{ "action": "scales.deleteUserData", "params": { "device_id": "vdevo158452200194602", "user_id": "97" } }

响应示例

{ "success":true, "t":1573441137, "result":true }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法

获取用户趋势数据

接口说明

获取用户趋势数据(默认显示当前周)

接口地址

action: scales.userTrendDatas

请求参数

参数名 类型 说明 是否必填
device_id String 设备ID
user_id String 添加的用户ID
start_day String 开始时间(“yyyyMMdd”)
end_day String 结束时间(“yyyyMMdd”)

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功
true:成功
false:失败
msg String 请求失败的信息,成功为空
result Array 趋势列表

result参数说明

参数名 参数类型 说明
day String 记录时间(以天为单位)
value String 称重记录(每天最新的一次称重记录)

请求示例

{ "action": "scales.userTrendDatas", "params": { "device_id": "vdevo158452200194602", "user_id": "97", "start_day": "20200202", "end_day": "20200209" } }

响应示例

{ "success":true, "t":1573441137, "result":[{ "value":"50.0", "day":"20190102" },{ "value":"51.0", "day":"20190103" }] }

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见全局错误码。

错误码 说明
500 系统错误
1106 权限非法