跳到主要内容

上传数据 API

上传运动数据 api

上传运动数据​

上传运动数据到后台

POST /openapi/v1/uploads/​

Payload​

请求参数​

字段名类型含义备注
name字符串运动的标题最大长度32个字符
detail字符串运动详情最大长度1500个字符
fit_filename字符串上传文件名文件名后缀要和file_type一致
file_type字符串文件类型文件的后缀, 已支持如下: fit
md5字符串文件md5值(32位小写)后台校验上传文件的md5要与该值一致

样例​

{
  "name": "骑行",
  "detail": "",
  "file_type": "fit",
  "fit_filename": "",
  "md5": ""
}

Response 201​

返回参数​

字段名类型含义备注
new布尔值是否为新上传
upload_id整型上传id本次上传记录id
workout_id整型轨迹id上传文件创建的轨迹id
credits浮点型热度上传轨迹产生的热度
uuid字符串uuid4本次上传记录的uuid

样例​

{
  "code": 0,
  "msg": "上传成功",
  "data": {
      "new": true,
      "upload_id": 1,
      "workout_id": 9,
      "credits": 100.0,
      "uuid": "123a1ba3-70d9-4867-b680-326e93f67a8e"
    }
}

获取上传运动数据记录列表​

获取用户上传数据的历史记录, 以分页的列表形式返回

GET /openapi/v1/uploads/​

请求参数​

参数位置含义备注
offsetquery获取偏移量从0开始
limitquery获取个数从1开始,最大值为20

返回参数​

字段名类型含义备注
count整型总条数返回用户历史记录总条数
previous字符串上一页没有上一页返回null
next字符串下一页没有下一页返回null
results数组记录列表没有数据返回空列表
new布尔值是否为新上传
upload_id整型上传id本次上传记录id
workout_id整型轨迹id上传文件创建的轨迹id
credits浮点型热度上传轨迹产生的热度
uuid字符串uuid4本次上传记录的uuid

样例​

{
  "count": 10,
  "previous": "",
  "next": "",
  "results": [
    {
      "new": true,
      "upload_id": 1,
      "workout_id": 9,
      "credits": 100.0,
      "uuid": "123a1ba3-70d9-4867-b680-326e93f67a8e"
    }
  ]
}

Error Response​

400​

{
  "code": 400,
  "msg": "API Limited",
  "data": {}
}

401​

{
  "code": 401,
  "msg": "Unauthorized Error",
  "data": {}
}

500​

{
  "code": 500,
  "msg": "Server Error",
  "data": {}
}