Skip to main content

运动 API

运动 api 信息

个人运动轨迹列表​

获取个人运动轨迹列表

GET /openapi/v1/activities/​

查询参数​

  • limit 轨迹分页，每页数目，默认 20
  • offset 轨迹分页 分页偏移量，默认 0
  • start_timestamp 轨迹开始时间大于 单位：毫秒
  • end_timestamp 轨迹开始时间小于 单位：毫秒

示例 筛选运动开始时间在 2025-01-01 到 2025-01-01 期间的轨迹列表​

/openapi/v1/activities/?start_timestamp=1735660800000&end_timestamp=1738339200000

Response 200​

字段详情​

样例​

{
    "count": 73,  // 轨迹总数
    "next": "http://www.imxingzhe.com/openapi/v1/workout/?limit=20&offset=20",  // 下一页链接
    "previous": null,  // 上一页链接
    "results": [
        {
            "id": 123,
            "start_time": 1516757704000,  // 开始时间， UNIX时间戳，单位毫秒
            "end_time": 1516758176000,  // 结束时间，UNIX时间戳，单位毫秒
            "distance": 1443,  // 运动距离，单位m
            "sport": 3,  // 运动类型 1:徒步 2:跑步 3:骑行
            "title": "2018-01-24 上午 骑行",
            "uuid": "4ddb92b5-1c54-418e-9d8b-e1ad59714f8e",
            "detail": "轨迹运动描述"
        },
    ]
}

轨迹详情信息​

指定轨迹id获取轨迹详情信息

GET /openapi/v1/activities/{id}/​

Response 200​

{
    "code": 0,
    "data": {
        "id": 36838086,
        "user_id": 2843350,
        "title": "2017-11-25 上午 骑行",
        "detail": "",
        "sport": 3,
        "distance": 78370,  // 轨迹距离，单位：米
        "duration": 16870,  // 持续时间单位：秒
        "device_name": "-",
        "start_time": 1511574741000,
        "end_time": 1511594503000,
        "upload_time": "2017-11-25 16:53:39",
        "calories": 2296121,
        "thumbnail": "https://static.imxingzhe.com/workout/d486ac6f-4873-4c96-8354-d2c63e18ba1a.png!workoutThumb",
        "avg_speed": 16.72,
        "max_speed": 12.9169371862359,
        "elevation_gain": 452,
        "elevation_loss": 453,
        "max_cadence": 0,
        "avg_cadence": 0,
        "max_grade": 17,
        "min_grade": -16,
        "max_heart_rate": 0,
        "avg_heart_rate": 0,
        "max_power": 841.53,
        "avg_power": 164.04,
        "power_ftp": 160.0,
        "power_np": 141.169,
        "power_if": 0.882,
        "power_tss": 364.796,
        "power_vi": 0.861,
        "min_alt": 0,
        "max_alt": 0,
        "weather": []
    },
    "msg": "OK"
}

Error Response​

400​

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

401​

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

500​

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