支付宝小程序API 运动数据

my.getRunData

版本要求：基础库 1.17.1 或更高版本；支付宝客户端 10.1.60 或更高版本，若版本较低，建议做 兼容处理

注意：

• IDE 模拟器暂不支持调试，请以真机调试结果为准。
• 此 API 暂仅支持企业支付宝账户使用。

获取用户一个自然天内的运动步数信息。

调用本 API 时无需再接入授权 API，系统将自动会检查用户是否已授权。若用户尚未授权，则会弹出授权框；用户同意授权后，可获取到返回的加密数据。 然后在服务端结合签名算法和 AES 密钥进行解密，获取运动数据。

目前只支持查询最近 30 天内的运动数据，若超过 30 天，则返回的步数信息为 0。

示例代码

my.getRunData({
  countDate: '2018-12-19',
  timeZone: 'Asia/Shanghai',
  fail: (res) => {
    console.log('get pedometer encrypted fail:'+JSON.stringify(res))
  },
  success: (res) => {
    let that = this;
    console.log('get pedometer encrypted success:'+JSON.stringify(res))
    my.request({
      url: 'http://www.telmo.cn/gateway/decrypt',
      data: {
        encryptKey: 'VyxFi6ZJtYz1UGLFZYPD9g==',
        encryptContent: res.response
      },
      success: function(res) {
        console.log('decrypt pedometer success:'+JSON.stringify(res))
        that.setData({
          step: res.data.count
        })
      },
      fail: function(res) {
        console.log('decrypt pedometer fail:'+JSON.stringify(res))
      }
    })
  },
  complete: (res) => {
    console.log('getRunData complete:' + JSON.stringify(res))
  }
})

入参

接口返回值

res.response 为完整的报文数据，前端需要将该报文发送到开发者服务端做验签和解密处理，服务端解密后的明文示例如下：

正常响应

{
    "count": "16880",
    "countDate": "2018-12-19",
    "code": "10000",
    "timeZone": "Asia/Shanghai"
}

服务端接口异常响应

{
    "code": "40003",
    "msg": "Insufficient Conditions",
    "subCode": "isv.invalid-auth-relations",
    "subMsg": "无效的授权关系"
}


{
    "code": "20000",
    "msg": "Service Currently Unavailable",
    "subCode": "aop.unknow-error",
    "subMsg": "系统繁忙"
}


{
    "code": "40001",
    "msg": "Missing Required Arguments",
    "subCode": "isv.missing-default-signature-type",
    "subMsg": "应用未设置默认签名类型"
}
//解决方案：重新保存下开发者的密钥，或者设置下小程序的应用网关地址


{
    "code": "40002",
    "msg": "Invalid Arguments",
    "subCode": "isv.invalid-encrypt",
    "subMsg": "加密异常"
}
//解决方案：按文档重新设置AES密钥

结果码

常见问题 FAQ

安卓系统下的用户在未开启 my.getRunData 时，调用这个方法为何报错：SYNC getAPPInfo do not execute callback？

这是已知问题，会在基础库 1.23.0 版本修复，原因是同步 API 容器底层偶现异常导致。

调用 my.getRunData 运动数据为何报错缺少加密配置？

未配置开放平台 AES 密钥导致的报错。

1、登录支付宝 开放平台 ，在“管理中心”选择需要配置 AES 密钥的应用，在“ 应用详情-应用环境 ”页面配置 AES 密钥。

2、在开放平台，“ 账户密钥管理 ” 页面点击配置 AES 密钥。

两个入口选择其一即可完成配置。