nRF Cloud 簡介

nRF Cloud是Nordic提供的云服務，可以實現(xiàn)設備數(shù)據(jù)上云，OTA，輔助定位等功能。我們可以選擇所需的服務以及如何連接設備，或者使用云到云的服務，保持設備連接到我們自己的服務。

該平臺基于亞馬遜云服務 (AWS) 構(gòu)建，集成了多個微服務。您和您的設備可以通過網(wǎng)頁門戶以及 REST、MQTT 和 CoAP API 與 nRF Cloud 服務交互。您還可以根據(jù)具體用例組合使用這些接口。

nRF Cloud 適用于多種用戶，包括使用 Nordic Semiconductor 芯片開發(fā)新產(chǎn)品的硬件或軟件工程師、設備群管理人員，以及使用 nRF Cloud REST API 為物聯(lián)網(wǎng)解決方案構(gòu)建自定義用戶界面的網(wǎng)頁或移動應用開發(fā)人員。

什么是nRF Cloud REST API

nRF Cloud REST API 是 nRF Cloud 提供的一組基于 REST（Representational State Transfer）架構(gòu)的應用程序接口。它允許開發(fā)者通過標準的 HTTP 請求與 nRF Cloud 平臺進行交互和通信。以下是 nRF Cloud REST API 的一些關(guān)鍵特點和功能：

設備管理

數(shù)據(jù)通信

安全

事件處理

用戶管理

通過 nRF Cloud REST API，開發(fā)者可以構(gòu)建自定義的 web 或移動應用程序，以實現(xiàn)對設備的遠程監(jiān)控、控制和管理。這使得開發(fā)者能夠靈活地集成 nRF Cloud 服務到現(xiàn)有的系統(tǒng)中，或者開發(fā)新的物聯(lián)網(wǎng)解決方案。

這個鏈接https://api.nrfcloud.com/v1/列出了所有 nRF Cloud REST API以及API的請求/應答數(shù)據(jù)格式。

本博客主要介紹怎么利用REST API實現(xiàn)云到云的數(shù)據(jù)交互。

準備工作一 —— 注冊nRF cloud 賬號

打開https://nrfcloud.com/#/

點擊Register，填好相關(guān)的信息后確認，此時就注冊了一個nRF cloud的開發(fā)者（developer）賬號。

如果想要體驗更多的nRF Cloud服務，如agps輔助定位，wifi定位我們需要將developer賬號升級到pro升級方式如下：

? 進入nrf cloud的DASHBOARD界面，點擊頁面右上角的plan setting選項

? 點擊 Change plan按鈕

? 此時會彈出三個等級賬號的資費標準和權(quán)限，DEVELOPER就是我們剛剛注冊的賬號等級，Pro為高級賬號，ENTERPRISE為企業(yè)賬號，升級企業(yè)賬號需要跟Nordic的銷售人員聯(lián)系，我們會根據(jù)實際情況給出收費標準。關(guān)于賬號的詳細介紹可以參考此鏈接：https://docs.nrfcloud.com/AccountAndTeamManagement/Plans/PlanOverview.html

? 點擊PRO下的upgrade!填寫相關(guān)信息，包括公司信息，信用卡卡號等，即可完成升級。

準備工作二—— 安裝rest api工具Postman

根據(jù)以下鏈接安裝POSTMAN并試驗發(fā)送請求。

https://learning.postman.com/docs/getting-started/first-steps/get-postman/

https://learning.postman.com/docs/getting-started/first-steps/sending-the-first-request/

準備工作三—— 生成Token

Token分為三種，API Key,JSON Web Token (JWT)，和 Service Evaluation Token。REST API 使用 API key對用戶進行身份認證，使用 JSON Web Token (JWT) 對設備進行身份認證。nRF Cloud REST API 中的某些API要用JWT，這些API在Authorizations字段需要填入 JSON Web Token。而有些API只需要用API key做認證即可。某些API，如 FetchCurrentPendingFOTAJobExecution，支持這兩種認證方式。Service Evaluation Token起到的作用跟JWT一樣，只不過它只有30天有效期。

API Key 在nRF cloud 賬號生成的時候就自帶了，點擊右上角的user account就可以找到。

如果你是開發(fā)者賬號Service Evaluation Token 在Team里面生成，如果你是Pro賬號，在這里生成的則是沒有使用時間限制的JWT。

示例

準備工作做完了，我們就可以正式使用REST API了。下面舉幾個REST API的例子：

獲取設備信息：

用curl指令使用此API：

curl https://api.nrfcloud.com/v1/devices -H "Authorization: Bearer 0b6f1715f8e7xxxxx205752xxxxx5aeffa39"

這條API，類型是GET， 認證類型是Bearer token,Token類型是simple token，即API Key,以上指令中緊跟著Bearer后的就是nRF CLOUD賬戶中對應的API Key。

同樣，我們也可以使用POSTMAN來完成，如下圖所示，填入正確的API類型，API地址，認證類型和Token后，點擊send,在回復框中能夠得到nrf cloud的回復，列出所有設備的信息。

通過WIFI熱點的SSID來獲取WIFI定位坐標

curl指令示例：

curl -X POST https://api.nrfcloud.com/v1/location/wifi -H "Authorization: Bearer " -H "Content-Type: application/json" -d {"accessPoints":[{"macAddress":"40:9b:cd:c1:5a:40","ssid":"Nordic_WLAN_5GHz"},{"macAddress":"00:90:fe:eb:4f:42","ssid":"Nordic_Guest"}]}

這條指令API類型為POST，包含兩個header（-H），一個是Authorization，一個是Content-Type，在Authorization中輸入nrf cloud賬號相關(guān)的JWT，在Content-Type中選擇 application/json，說明我們的請求主體是json格式的，接下來-d字符后面跟著的就是以json格式編輯的WIFI的ssid和MAC地址。

同樣，在POSTMAN中，如下圖所示，填入API地址，類型選擇為POST，Token此時填入的是JWT。

然后在Header中確認選中content type為application/json

然后再Body中填入請求主體，即json格式的WIFI SSID和MAC地址，最后點擊Send，我們就可以在下面的回復框中得到經(jīng)緯度和誤差。

審核編輯 黃宇