文档中心 > API类目 > 阿里体育API

alibaba.alisports.data.sports.syncsportsdata (阿里体育数据中心用户运动数据同步接口)

阿里体育数据中心用户运动数据同步接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
alisp_app_key String 必须 test_appkey 应用appkey
max_speed String 可选 1 最高速度 单位:米/每分
aver_heartrate Number 可选 1 平均心率 单位:次/每分
max_heartrate Number 可选 1 最高心率 单位:次/每分
min_heartrate Number 可选 1 最低心率 单位:次/每分
trail String 可选 none 运动轨迹,有序的经纬度集合,json格式 例:[[1,2],[3,4]] [1,2]是一个坐标点,1是经度 2是纬度(有就传,阿里体育较依赖此字段)
stime String 可选 2018-10-10 11:11:11 运动开始时间(如果不区分开始结束,两个时间值相同;格式:Y-m-d H:i:s)
etime String 可选 2018-10-10 11:11:11 运动结束时间(如果不区分开始结束,两个时间值相同;格式:Y-m-d H:i:s)
device_type Number 可选 1 设备类型 :1.手环;2.手表;3.跑步机;4.智能运动鞋;5.耳机;6.智能运动鞋;7.智能运动Bra8.智能单车;9.智能跳绳10.智能背心11.脚环
device_name String 可选 none 设备名(展示会用到)
device_model String 可选 1 设备型号
aver_speed String 可选 1 平均速度 单位:米/每分
sub_unit Number 可选 1 二级运动量单位 定义:1.爬楼层数(跑步、健走、健身、登山);2.划水次数(游泳)
sub_num String 可选 1 二级运动量
alisp_time String 必须 1234567890 时间戳精确到秒
alisp_sign String 必须 abc 接口签名
aliuid String 必须 abc 阿里体育用户id
source String 可选 abc 业务来源二级分类(中英文)
data_id String 必须 abc 三方运动数据主键id(数据唯一标记,去重使用)
sports_class Number 必须 1 运动类型一级分类 定义:1-跑步;2-健走;3-骑行;4-游泳;5-健身;6-篮球;7-足球;8-羽毛球;9-排球;10-乒乓球;11-瑜伽;12-电竞;13-登山;16-椭圆机;19-健身操;20-太极;
sports_type Number 可选 0 运动类型二级分类 定义: 1001-室内跑步;1002-室外跑步;2001-室内健走;2002-室外健走;3001-室内骑行;3002-室外骑行;4001-室内游泳;4002-户外游泳
num String 可选 1 运动量
unit Number 可选 1 运动量单位 1.步数(跑步、健走、椭圆机、登山);2.趟数(游泳);3.平均踏频(骑行);
calorie String 可选 1 运动消耗卡路里 单位:卡
match String 可选 none 所属赛事(有就传,阿里体育较依赖此字段)
distance String 可选 100 运动距离 单位:米(有就传,阿里体育较依赖此字段)
time String 可选 100 运动时长 单位:秒(有就传,阿里体育较依赖此字段)
country String 可选 中国 国家(中英文/运动发生地点,如有就传)
province String 可选 上海市 省份(中英文/运动发生地点,如有就传)
city String 可选 杨浦区 城市(中英文/运动发生地点,如有就传)
start_point String 可选 130.0,37.0 开始运动地点经纬度,格式:1,2 (1为经度,2为纬度)
end_point String 可选 130.0,37.0 结束运动地点经纬度,格式:1,2 (1为经度,2为纬度)

响应参数

名称 类型 示例值 描述
alisp_code Number 200 alisp_code
alisp_msg String 操作成功 alisp_msg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlisportsDataSportsSyncsportsdataRequest req = new AlibabaAlisportsDataSportsSyncsportsdataRequest();
req.setAlispAppKey("test_appkey");
req.setMaxSpeed("1");
req.setAverHeartrate(1L);
req.setMaxHeartrate(1L);
req.setMinHeartrate(1L);
req.setTrail("none");
req.setStime("2018-10-10 11:11:11");
req.setEtime("2018-10-10 11:11:11");
req.setDeviceType(1L);
req.setDeviceName("none");
req.setDeviceModel("1");
req.setAverSpeed("1");
req.setSubUnit(1L);
req.setSubNum("1");
req.setAlispTime("1234567890");
req.setAlispSign("abc");
req.setAliuid("abc");
req.setSource("abc");
req.setDataId("abc");
req.setSportsClass(1L);
req.setSportsType(0L);
req.setNum("1");
req.setUnit(1L);
req.setCalorie("1");
req.setMatch("none");
req.setDistance("100");
req.setTime("100");
req.setCountry("中国");
req.setProvince("上海市");
req.setCity("杨浦区");
req.setStartPoint("130.0,37.0");
req.setEndPoint("130.0,37.0");
AlibabaAlisportsDataSportsSyncsportsdataResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alisports_data_sports_syncsportsdata_response>
    <alisp_code>200</alisp_code>
    <alisp_msg>操作成功</alisp_msg>
</alibaba_alisports_data_sports_syncsportsdata_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部