Cloud.CloudID(cloudID: string)

支持端:小程序 2.7.0, Web 1.1.0

声明字符串为 CloudID(开放数据 ID),该接口传入一个字符串,返回一个 CloudID 特殊对象,将该对象传至云函数可以获取其对应的开放数据。详见通过云调用获取开放数据

参数

cloudID: string

通过开放能力在小程序端 / web 端获取得到的 CloudID

示例代码

小程序端调用

  1. wx.cloud.callFunction({
  2. name: 'myFunction',
  3. data: {
  4. weRunData: wx.cloud.CloudID('xxx'), // 这个 CloudID 值到云函数端会被替换
  5. obj: {
  6. shareInfo: wx.cloud.CloudID('yyy'), // 非顶层字段的 CloudID 不会被替换,会原样字符串展示
  7. }
  8. }
  9. })

在云函数端接收到的 event 将会包含对应开放数据的对象,其中 event.weRunData 会因为符合规则而包含开放数据,event.shareInfo 则不会,event 结构将如下:

  1. {
  2. "weRunData": {
  3. "cloudID": "27_Ih-9vxDaOhIbh48Bdpk90DUkUoNMAPaNtg7OSGM-P2wPEk1NbspjKGoql_g",
  4. "data": {
  5. "stepInfoList": [
  6. {
  7. "step": 9103,
  8. "timestamp": 1571673600
  9. },
  10. {
  11. "step": 9783,
  12. "timestamp": 1571760000
  13. }
  14. ],
  15. "watermark": {
  16. "appid": "wx3d289323f5900f8e",
  17. "timestamp": 1574338655
  18. }
  19. }
  20. },
  21. "obj": {
  22. "shareInfo": "xxx"
  23. }
  24. }