使用Postman獲取里程表數(shù)據(jù)的步驟

為了順利使用REST API獲取車輛數(shù)據(jù)，建議按照以下步驟操作：

1. 設(shè)置Postman環(huán)境和收藏。
2. 生成車輛訪問令牌。
3. 通過車輛狀態(tài)端點(diǎn)檢索里程表數(shù)據(jù)。

以下將逐步介紹每個(gè)步驟的具體操作。

設(shè)置和配置Postman

下載和安裝Postman

如果您尚未安裝Postman，請從官方渠道下載并安裝該工具。完成安裝后，您可以通過High Mobility平臺(tái)的沙盒環(huán)境進(jìn)行測試。

獲取Postman配置文件

登錄High Mobility平臺(tái)，進(jìn)入“構(gòu)建”環(huán)境，選擇您的應(yīng)用程序容器。在“客戶端證書”選項(xiàng)卡中，下載相應(yīng)的Postman配置文件。目前，該選項(xiàng)僅適用于單驅(qū)動(dòng)程序應(yīng)用程序，但未來將支持車隊(duì)管理。此外，您還可以通過High Mobility的GitHub頁面獲取B2C和Fleet用途的Postman集合和環(huán)境文件。

導(dǎo)入Postman配置

打開Postman，點(diǎn)擊“導(dǎo)入”按鈕，選擇下載的環(huán)境和集合文件并確認(rèn)導(dǎo)入。導(dǎo)入完成后，您將在左側(cè)看到一系列請求和端點(diǎn)。

配置環(huán)境變量

在Postman左側(cè)導(dǎo)航欄中選擇“環(huán)境”，確保已正確設(shè)置以下變量：

• APP_ID：對(duì)應(yīng)High Mobility平臺(tái)中應(yīng)用容器的標(biāo)識(shí)符。
• REST_API_CONFIG：包含在“客戶端證書 > REST API”下的完整代碼段。
• BASE_URL：對(duì)應(yīng)REST API代碼段中的API_URL值。
• TOKEN_URI：與數(shù)據(jù)容器的OAuth客戶端設(shè)置中的值匹配。

完成配置后，保存更改。

生成車輛訪問令牌

車輛激活后，您需要生成訪問令牌以調(diào)用API并獲取車輛數(shù)據(jù)。以下是生成訪問令牌的具體步驟：

1. 使用../flowers/acces_tokens端點(diǎn)獲取訪問令牌。此端點(diǎn)需要提供車輛識(shí)別碼（VIN）和身份驗(yàn)證令牌作為參數(shù)。
2. 如果您不清楚如何生成身份驗(yàn)證令牌，可參考High Mobility的開放式開發(fā)講座第5期。
3. 執(zhí)行請求后，您將收到一個(gè)訪問令牌，同時(shí)還會(huì)獲得數(shù)據(jù)點(diǎn)范圍和刷新令牌。

將生成的訪問令牌復(fù)制到Postman環(huán)境中的相應(yīng)字段，并保存更改。

通過REST API獲取里程表數(shù)據(jù)

在Postman的收藏概述中，車輛數(shù)據(jù)被分類打包到不同的端點(diǎn)中。由于里程表數(shù)據(jù)屬于診斷類別，您可以通過相關(guān)端點(diǎn)直接檢索數(shù)據(jù)。然而，更推薦使用“獲取車輛狀態(tài)”端點(diǎn)，因?yàn)樗鼤?huì)返回所有已激活的數(shù)據(jù)點(diǎn)，無論其類別如何。

操作步驟

1. 選擇“獲取車輛狀態(tài)”端點(diǎn)。
2. 點(diǎn)擊“發(fā)送”按鈕，Postman將執(zhí)行請求。
3. 在響應(yīng)視圖中查看結(jié)果，您將看到包含以下信息的數(shù)據(jù)項(xiàng)列表：
   • 車輛識(shí)別碼（VIN）
   • 品牌名稱
   • 時(shí)間戳（UTC+0）
   • 里程表數(shù)據(jù)

例如，在某次請求中，車輛的里程為6871公里，根據(jù)時(shí)間戳可判斷車輛在過去兩天內(nèi)未行駛。

總結(jié)

通過本文的指導(dǎo)，您可以使用Postman工具輕松獲取車輛的里程表數(shù)據(jù)。無論是配置環(huán)境、生成訪問令牌，還是調(diào)用REST API獲取數(shù)據(jù)，每一步都至關(guān)重要。希望本文能為您在聯(lián)網(wǎng)汽車數(shù)據(jù)的開發(fā)和測試中提供幫助。

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