宅客智能体测仪数据对接

                                宅客智能体测仪数据对接

使用说明：本文档适用于宅客科技旗下的智能体测仪（成人智能体测仪M3/M1、儿童智能体测仪K2、全功能款智能体测仪A5）和心率监测系统H1产品。

购买以上产品的客户可参照本文档进行产品的数据对接，产品数据对接服务分为被动查询方式和主动回调方式，被动查询方式可按照下列数据接口查询获得，详情请参阅下面的接口文档。主动回调方式需客户提供回调公网回调地址，在我方平台配置生效后，产生数据时将主动发起相应网址的数据请求，将数据以post请求表单提交方式推送数据至配置的公网地址，详情请参阅相应接口说明。

1.获取APIKEY接口

(1) 接口地址：https://www.zhaiker.cn/OpenAPI!apiKey.msg

（2）接口输入参数：

参数名称	数据格式	是否必填	备注
account	string	是	账户名
password	string	是	密码，需进行MD5（32位小写）加密，否则会提示密码错误

（3）接口返回数据：

{

"STATUS": true, //接口状态，true表示正常，false表示异常

"CODE": 0, //错误码，0表示正常，200表示账户名错误，300表示账户状态异常，可能的原因是账户被冻结、尚未审批通过、停用等，400表示密码错误，500表示内部错误

"apiKey": "3nk3nJ2H0C8Zo0wr+vL", //返回该账户的api秘钥!

"gymId": "xxxxxxxxxxxx", //返回该账户的门店编号ID

"INFO": "成功" //接口返回备注信息

}

2.获取体测记录接口

（1）接口地址：https://www.zhaiker.cn/OpenAPI!getExams.msg

（2）接口输入参数：

参数名称	数据格式	是否必填	备注
apiKey	string	是	get请求时需进行url编码
name	string	否	根据姓名搜索
phone	string	否	根据电话号码搜索
timeStart	string	否	时间段开始时间，支持格式"yyyy-MM-dd HH:mm:ss","yyyy-MM-dd", "yyyy/MM/dd HH:mm:ss", "yyyy/MM/dd","HH:mm:ss","yyyy年MM月dd日 HH时mm分ss秒","yyyy年MM月dd日"
timeEnd	string	否	时间段结束时间,格式同上，需注意的是timeStart与timeEnd必须成对出现，否则不生效
pageIndex	int	否	分页页码，默认0
pageSize	int	否	分页大小，默认每页30条记录

（3）接口返回数据：

{

"STATUS": true, //接口状态，true表示正常，false表示异常

"CODE": 0, //错误码，0表示正常，100表示秘钥错误，500表示内部错误

"DATA": [{ //体测数据记录，JSON数组格式

"aerobicGoal": 526.05, //有氧运动目标 单位大卡

"age": 18, //年龄

"agility": 636, //敏捷反应时间 单位毫秒

"anaGoal": 75.15, //无氧运动目标 单位大卡

"balance": 2, //平衡能力 1~5 分 1很差，2较差，3一般 4较好 5很好

"balanceAngle": 40.8411, //平衡能力，100%满分，当前表示40.8411%

"bmi": 23.0, //BMI

"bmr": 1670.0, //基础代谢

"bodyAge": 26, //身体年龄

"bodyImage": "2019-10-15/1571108144859500400.jpg", //正面体态照片，地址传入接口4可获取照片

"bodyShape": 1, //形体判定，0隐形肥胖 1偏胖 2肥胖 3偏瘦肌肉 4 标准型 5非常肌肉 6偏瘦 7 标准肌肉 8 运动不足

"bone": 3.01, //骨量

"caloriesInput": 1670.0,//每日热量摄入 单位大卡

"deviceFrom": "2032337d5958", //体测设备ID

"enduGoal": 150.3,//体能耐力每日运动目标 单位大卡

"fat": 28.3, //体脂率

"fatControl": -11.172, //体脂控制建议

"gmtCreate": 1571108150000, //体测创建时间

"gmtModify": 1571108150000,//体测修改时间

"height": 174.3,//身高

"id": "3000001588015449",//体测ID

"inFat": 10.0,//内脏脂肪

"muscle": 46.3,//肌肉率

"muscleControl": 3.724,//肌肉控制建议

"name": "匿名",//姓名

"perfectWeight": 64.4066,//理想体重

"phone": "13691537379",//电话

"protein": 16.38,//蛋白质

"score": 58,//体测评分

"sex": "M",//性别 M为男性，F为女性

"sideImage": "2019-10-15/1571108142548217300.jpg", //侧面形体照片

"sportGoal": 751.5,//每日总运动目标，单位大卡

"subFat": 25.1,//皮下脂肪

"userId": "1571108149804725100",//用户ID

"vitalCapacity": 4207,//肺活量 单位毫升

"bloodMaxPressure": 128,//收缩压，单位毫米汞柱

"bloodMinPressure": 78,//舒张压，单位毫米汞柱

"restingHeartRate": 68,//静态心率

"heartFun": 4,//心肺功能评级，0~5分制，5为满分

"bloodOxygen": 98,//血氧浓度，单位百分比

"water": 51.7,//身体水分

"weight": 84.0,//体重

"weightControl": -7.448 //体重控制建议，

"bodyDetect": "{\"left_ankle\":{\"score\":0.81988263,\"x\":330.5,\"y\":364.25},\"left_elbow\":{\"score\":0.85873,\"x\":337.375,\"y\":158},\"left_hip\":{\"score\":0.7652891,\"x\":316.75,\"y\":206.125},\"left_knee\":{\"score\":0.82790756,\"x\":323.625,\"y\":281.75},\"left_shoulder\":{\"score\":0.90280265,\"x\":323.625,\"y\":103},\"left_wrist\":{\"score\":0.86308056,\"x\":337.375,\"y\":206.125},\"neck\":{\"score\":0.85809946,\"x\":296.125,\"y\":82.375},\"right_ankle\":{\"score\":0.84468603,\"x\":282.375,\"y\":364.25},\"right_elbow\":{\"score\":0.84944564,\"x\":261.75,\"y\":123.625},\"right_hip\":{\"score\":0.7674172,\"x\":282.375,\"y\":206.125},\"right_knee\":{\"score\":0.8361144,\"x\":282.375,\"y\":288.625},\"right_shoulder\":{\"score\":0.8262944,\"x\":268.625,\"y\":96.125},\"right_wrist\":{\"score\":0.8221415,\"x\":282.375,\"y\":82.375},\"top_head\":{\"score\":0.7811405,\"x\":296.125,\"y\":41.125}}",//正面形体体态识别数据，JSON格式字符串，分别表示各个骨骼点所在的位置坐标，单位像素

"humpbackRisk": 1,//驼背风险，1~5级，得分越高，风险越高

"legRisk": "X2",//X、O型腿风险，首字母X，O表示风险类型，数字表示风险等级

"pelvisRisk": 1,//骨盆前倾风险，1~5级，得分越高，风险越高

"sideBodyDetect": "{\"left_ankle\":{\"score\":0.722427,\"x\":297.5,\"y\":373},\"left_elbow\":{\"score\":0.6182916,\"x\":305,\"y\":155.5},\"left_hip\":{\"score\":0.6708844,\"x\":305,\"y\":200.5},\"left_knee\":{\"score\":0.7768335,\"x\":305,\"y\":290.5},\"left_shoulder\":{\"score\":0.7716159,\"x\":297.5,\"y\":88},\"left_wrist\":{\"score\":0.39605314,\"x\":327.5,\"y\":200.5},\"neck\":{\"score\":0.85938156,\"x\":297.5,\"y\":73.000015},\"right_ankle\":{\"score\":0.775244,\"x\":297.5,\"y\":380.5},\"right_elbow\":{\"score\":0.85210884,\"x\":305,\"y\":155.5},\"right_hip\":{\"score\":0.7619905,\"x\":305,\"y\":200.5},\"right_knee\":{\"score\":0.7822206,\"x\":297.5,\"y\":290.5},\"right_shoulder\":{\"score\":0.8641562,\"x\":297.5,\"y\":95.50001},\"right_wrist\":{\"score\":0.80948156,\"x\":320,\"y\":208},\"top_head\":{\"score\":0.8301873,\"x\":305,\"y\":28.000015}}",//侧面形体体态识别数据，JSON格式字符串，分别表示各个骨骼点所在的位置坐标，单位像素

"shoulderRisk": 3,//高低肩风险等级

//8电极设备增加数据

"muscleLeftArm" : 3.11 //左上肌肉

"muscleRightArm" : 2.99 //右上肌肉

"fatLeftArm" : 0.84 //左上脂肪

"fatRightArm" : 0.93 //右下脂肪

"muscleTrunk" : 29.15 //躯干肌肉

"fatTrunk" : 8.35 //躯干脂肪

"muscleLeftLeg" : 9.79 //左下肌肉

"muscleRightLeg" : 9.71 //右下肌肉

"fatLeftLeg" : 2.87 //左下脂肪

"fatRightLeg" : 2.84 //右下脂肪

"r20LeftArm" : 349.1 //20kHz左上肢

"r20LeftLeg": 258.0 //20kHz左下肢

"r20RightArm" : 349.1 //20kHz右上肢

"r20RightLeg" : 252.2 //20kHz右下肢

"r20Trunk" : 23.1 //20kHz躯干

"r100LeftArm" : 326.5 //100kHz左上肢

"r100LeftLeg" : 224.9 //100kHz左下肢

"r100RightArm" : 309.3 //100kHz右上肢

"r100RightLeg" : 218.4 //100kHz右下肢

"r100Trunk" : 19.2 //100kHz躯干

//身体维度数据（设备上做过体姿态评估才有此数据）

"wc": 1.16638,//腰臀比

"waist":20.1, //腰围长度

"hips":20.1, //臀围长度

"head":20.1, //头部高度

"upperBody":20.1, //上半身长度

"lowerBody":20.1, //下半身长度

"shank":20.1, //小腿长度

"thigh":20.1, //大腿长度

"armSpan":20.1, //臂展

"armDim":20.1, //臂围

"thigh_dim":20.1, //大腿维度

"shoulder_width":20.1, //肩宽

"occipital_space":20.1, // 枕间距

},

],

"INFO": "成功" //接口返回备注信息

}

3.获取体测数量接口

（1）接口地址：https://www.zhaiker.cn/OpenAPI!getExamsCount.msg

（2）接口输入参数：

参数名称	数据格式	是否必填	备注
apiKey	string	是	get请求时需进行url编码
name	string	否	根据姓名搜索
phone	string	否	根据电话号码搜索
timeStart	string	否	时间段开始时间
timeEnd	string	否	时间段结束时间
pageIndex	int	否	分页页码，默认0
pageSize	int	否	分页大小，默认每页30条记录

（3）接口返回数据：

{

"STATUS": true, //接口状态，true表示正常，false表示异常

"CODE": 0, //错误码，0表示正常，100表示秘钥错误，500表示内部错误

"DATA": 1, //返回记录数量

"INFO": "成功" //接口返回备注信息

}

4.根据ID获取体测数据接口

（1）接口地址：https://www.zhaiker.cn/OpenAPI!getExamById.msg

（2）接口输入参数：

参数名称	数据格式	是否必填	备注
apiKey	string	是	get请求时需进行url编码
id	string	是	体测记录ID

（3）接口返回数据：

{

"standard": { //各项数据的参照标准

"bmiStandard": { //BMI参照标准

"age": 0, //无需理会

"fewer": 20.0, //偏低值

"fewest": 16.0, //过低值

"more": 23.5, //偏高值

"most": 27.0, //过高值

"standard": 21.2 //标准值

},

"boneStandard": {//骨量标准

"age": 0,

"fewer": 2.7,

"fewest": 2.3,

"more": 3.1,

"most": 3.5,

"standard": 2.9

},

"visfatStandard": {//内脏脂肪标准

"age": 0,

"fewer": 0.0,

"fewest": -4.0,

"more": 5.0,

"most": 9.0,

"standard": 1.0

},

"bmrStandard": {//基础代谢标准

"age": 0,

"fewer": 1425.2739,

"fewest": 950.1827,

"more": 1742.0015,

"most": 1900.3654,

"standard": 1583.6377

},

"subfatStandard": {//皮下脂肪标准

"age": 0,

"fewer": 8.6,

"fewest": 0.6,

"more": 17.7,

"most": 26.7,

"standard": 10.0

},

"waterStandard": {//水分标准

"age": 0,

"fewer": 55.0,

"fewest": 45.0,

"more": 65.0,

"most": 75.0,

"standard": 55.0

},

"fatStandard": {//体脂率标准

"age": 0,

"fewer": 11.0,

"fewest": 2.0,

"more": 20.0,

"most": 29.0,

"standard": 15.0

},

"proteinStandard": {//蛋白质标准

"age": 0,

"fewer": 15.0,

"fewest": 11.0,

"more": 19.0,

"most": 23.0,

"standard": 17.0

},

"whrStandard": {//腰臀比标准

"age": 0,

"fewer": 0.8,

"fewest": 0.65,

"more": 0.95,

"most": 1.1,

"standard": 0.85

},

"muscleStandard": {//肌肉标准

"age": 0,

"fewer": 50.0,

"fewest": 35.0,

"more": 65.0,

"most": 80.0,

"standard": 55.0

},

"weightStandard": {//体重标准

"age": 0,

"fewer": 58.482002,

"fewest": 46.785603,

"more": 68.716354,

"most": 78.95071,

"standard": 61.990925

},

"heightStandard": {//身高标准

"age": 18,

"fewer": 166.6,

"fewest": 154.4,

"more": 178.7,

"most": 190.6,

"standard": 172.7

}

},

"weightGrowthStandard": [ //体重成长的趋势表 只有年龄小于18岁时才有该项标准

[2.0, 9.06, 11.24, 12.54, 14.01, 17.54],

[3.0, 10.61, 13.13, 14.65, 16.39, 20.64],

[4.0, 12.01, 14.88, 16.64, 18.67, 23.73],

[5.0, 13.5, 16.87, 18.98, 21.46, 27.85],

[6.0, 14.74, 18.71, 21.26, 24.32, 32.57],

[7.0, 16.01, 20.83, 24.06, 28.05, 39.5],

[8.0, 17.33, 23.23, 27.33, 32.57, 48.57],

[9.0, 18.53, 25.5, 30.46, 36.92, 57.3],

[10.0, 19.81, 27.93, 33.74, 41.31, 65.08],

[11.0, 21.41, 30.95, 37.69, 46.33, 72.39],

[12.0, 23.37, 34.67, 42.49, 52.31, 80.35],

[13.0, 26.21, 39.22, 48.08, 59.04, 89.42],

[14.0, 30.4, 44.08, 53.37, 64.84, 96.8],

[15.0, 34.59, 48.0, 57.08, 68.35, 100.29],

[16.0, 37.67, 50.62, 59.35, 70.2, 101.25],

[17.0, 39.58, 52.2, 60.68, 71.2, 101.39],

[18.0, 40.65, 53.08, 61.4, 71.73, 101.36]

],

"STATUS": true, //接口状态

"CODE": 0, //接口状态码

"DATA": { //体测数据，含义同接口一表示

"aerobicGoal": 488.565,

"age": 28,

"anaGoal": 69.795,

"bmi": 23.0,

"bmr": 1551.0,

"bodyAge": 33,

"bodyShape": 1,

"bone": 2.74,

"caloriesInput": 1551.0,

"customerId": "1521523488110511800",

"deviceFrom": "2032337d6194",

"enduGoal": 139.59,

"fat": 26.2,

"fatControl": -8.2992,

"gmtCreate": 1571297302000,

"gmtModify": 1571297302000,

"gymId": "gym1461205683189585401",

"heartFun": 5,

"height": 171.0,

"id": "8000000322198329",

"impedanceOne": 560.0,

"impedanceTwo": 488.0,

"inFat": 8.0,

"isDeleted": "n",

"muscle": 47.7,

"muscleControl": 2.7664,

"name": "JASON",

"perfectWeight": 61.9909,

"phone": "17771879139",

"protein": 16.81,

"score": 66,

"sex": "M",

"sportGoal": 697.95,

"subFat": 23.5,

"userId": "1500431093729489800",

"water": 53.3,

"wc": 1.08473,

"weight": 74.1,

"weightControl": -5.5328

},

"heightGrowthStandard": [ //身高成长的趋势表 只有年龄小于18岁时才有该项标准

[2.0, 78.3, 85.1, 88.5, 92.1, 99.5],

[3.0, 85.6, 93.0, 96.8, 100.7, 108.7],

[4.0, 92.5, 100.2, 104.1, 108.2, 116.5],

[5.0, 98.7, 107.0, 111.3, 115.7, 124.7],

[6.0, 104.1, 113.1, 117.7, 122.4, 132.1],

[7.0, 109.2, 119.0, 124.0, 129.1, 139.6],

[8.0, 114.1, 124.6, 130.0, 135.5, 146.8],

[9.0, 118.3, 129.6, 135.4, 141.2, 153.3],

[10.0, 122.0, 134.0, 140.2, 146.4, 159.2],

[11.0, 125.7, 138.7, 145.3, 152.1, 165.8],

[12.0, 130.0, 144.6, 151.9, 159.4, 174.5],

[13.0, 136.3, 151.8, 159.5, 167.3, 183.0],

[14.0, 144.3, 158.7, 165.9, 173.1, 187.4],

[15.0, 150.1, 163.3, 169.8, 176.3, 189.3],

[16.0, 152.9, 165.4, 171.6, 177.8, 190.1],

[17.0, 154.0, 166.3, 172.3, 178.4, 190.5],

[18.0, 154.4, 166.6, 172.7, 178.7, 190.6]

],

"INFO": "success" //接口返回备注

}

5.照片显示路径接口

（1）接口地址：https://www.zhaiker.cn/file/FileAction!loadFile.msg

（2）接口输入参数：

参数名称	数据格式	是否必填	备注
key	string	是	文件地址

（3）接口返回数据：

直接跳转图片