如何使用Postman通过REST API获取里程表数据？

在本指南中，我们将详细介绍如何使用Postman工具，通过High Mobility的REST API获取车辆的里程表数据。本文假设您已经创建了免费的High Mobility账户，并完成了数据容器的设置工作。此外，您的应用程序已获得批准，车辆也已激活。如果尚未完成这些步骤，建议您先参考High Mobility的开放式开发讲座“如何开始使用联网汽车数据？”和“如何管理同意和连接车队车辆”。

使用Postman获取里程表数据的步骤

为了顺利使用REST API获取车辆数据，建议按照以下步骤操作：

1. 设置Postman环境和收藏。
2. 生成车辆访问令牌。
3. 通过车辆状态端点检索里程表数据。

以下将逐步介绍每个步骤的具体操作。

设置和配置Postman

下载和安装Postman

如果您尚未安装Postman，请从官方渠道下载并安装该工具。完成安装后，您可以通过High Mobility平台的沙盒环境进行测试。

获取Postman配置文件

登录High Mobility平台，进入“构建”环境，选择您的应用程序容器。在“客户端证书”选项卡中，下载相应的Postman配置文件。目前，该选项仅适用于单驱动程序应用程序，但未来将支持车队管理。此外，您还可以通过High Mobility的GitHub页面获取B2C和Fleet用途的Postman集合和环境文件。

导入Postman配置

打开Postman，点击“导入”按钮，选择下载的环境和集合文件并确认导入。导入完成后，您将在左侧看到一系列请求和端点。

配置环境变量

在Postman左侧导航栏中选择“环境”，确保已正确设置以下变量：

• APP_ID：对应High Mobility平台中应用容器的标识符。
• REST_API_CONFIG：包含在“客户端证书 > REST API”下的完整代码段。
• BASE_URL：对应REST API代码段中的API_URL值。
• TOKEN_URI：与数据容器的OAuth客户端设置中的值匹配。

完成配置后，保存更改。

生成车辆访问令牌

车辆激活后，您需要生成访问令牌以调用API并获取车辆数据。以下是生成访问令牌的具体步骤：

1. 使用../flowers/acces_tokens端点获取访问令牌。此端点需要提供车辆识别码（VIN）和身份验证令牌作为参数。
2. 如果您不清楚如何生成身份验证令牌，可参考High Mobility的开放式开发讲座第5期。
3. 执行请求后，您将收到一个访问令牌，同时还会获得数据点范围和刷新令牌。

将生成的访问令牌复制到Postman环境中的相应字段，并保存更改。

通过REST API获取里程表数据

在Postman的收藏概述中，车辆数据被分类打包到不同的端点中。由于里程表数据属于诊断类别，您可以通过相关端点直接检索数据。然而，更推荐使用“获取车辆状态”端点，因为它会返回所有已激活的数据点，无论其类别如何。

操作步骤

1. 选择“获取车辆状态”端点。
2. 点击“发送”按钮，Postman将执行请求。
3. 在响应视图中查看结果，您将看到包含以下信息的数据项列表：
   • 车辆识别码（VIN）
   • 品牌名称
   • 时间戳（UTC+0）
   • 里程表数据

例如，在某次请求中，车辆的里程为6871公里，根据时间戳可判断车辆在过去两天内未行驶。

总结

通过本文的指导，您可以使用Postman工具轻松获取车辆的里程表数据。无论是配置环境、生成访问令牌，还是调用REST API获取数据，每一步都至关重要。希望本文能为您在联网汽车数据的开发和测试中提供帮助。

原文链接: https://www.high-mobility.com/blog/how-to-get-odometer-data-via-rest-api-using-postman-opendevtalk7