官方服务中提供了一些获取官方数据的接口，开发者只需要选择具体的服务和服务版本，提供接口所需的参数即可获取数据。

目前平台提供了以下官方服务接口：

  • 获取蚂蚁森林能量总和
  • 获取当日课表信息列表
  • 获取备忘录信息列表
  • 获取物流列表信息
  • 股票大盘指数获取
  • 个股信息获取
  • 获取指定天的天气天气情况
  • 限行查询
  • 按照时间进行排名
  • 当前天气
  • 获取日期和时间和节日
  • 通话记录信息获取

一、创建官方服务

点击官方服务分类后的“+”号，创建一个官方服务数据源。
89.png
90.png

  1. 接口名称：此官方服务数据源的名称。最大长度为20，只支持英文和数字，且不能以数字开头。
  2. 选择服务：选择使用的官方服务接口。
  3. 选择版本：选择官方服务提供接口的不同版本。
  4. 请求参数：官方服务接口所需的参数。
  5. 数据过滤脚本：勾选数据过滤脚本，可以在下面的脚本中定义数据处理或过滤规则（支持JS脚本）。
  6. 返回结果：点击返回结果后的“刷新”按钮，用来获取新的返回结果。

当刷新返回结果获取最新的数据后，就可以点击“确认”保存数据源的配置。如果点击“取消”，则之前填写的信息不会保存，此官方服务数据源还处在未编辑状态（官方服务数据源名称后面有红点提示）。

二、选择服务

点击“服务名称”的下拉框，在下拉列表中选择需要的服务；然后点击“版本名称”下拉框，在下拉列表中选择不同的版本。
91.gif

三、填充参数

官方服务所需参数都是固定的，开发者只需要填入参数值或使用变量值即可，不需要添加新的参数。
例如：“获取蚂蚁森林能量总和”服务接口只需要一个参数“UserId”，我们就可以使用系统变量userId当做参数值传递。

使用系统变量时，需要先绑定真机测试设备，会根据选择的测试设备不同，有不同的取值。

92.gif

四、使用过滤脚本

官方服务中的数据过滤脚本，与API接口中的数据过滤脚本使用方法相同，请参考文档：API接口。

勾选启用“数据过滤脚本”，点击“运行”查看过滤器输入数据。然后编写过滤脚本，“运行”查看过滤器运行结果。例如：将return data修改为return data.Model.RemainEnergy，即可过滤出用户目前持有的蚂蚁森林能量值数据。
93.gif

五、刷新返回结果

在点击“确认”保存配置前，需要先刷新返回结果，获取接口数据或过滤器过滤后的数据。

如果刷新返回结果后更改了过滤规则，还需要重新刷新返回结果。