nRF Cloud 簡(jiǎn)介

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

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

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

什么是nRF Cloud REST API

nRF Cloud REST API 是 nRF Cloud 提供的一組基于 REST（Representational State Transfer）架構(gòu)的應(yīng)用程序接口。它允許開(kāi)發(fā)者通過(guò)標(biāo)準(zhǔn)的 HTTP 請(qǐng)求與 nRF Cloud 平臺(tái)進(jìn)行交互和通信。以下是 nRF Cloud REST API 的一些關(guān)鍵特點(diǎn)和功能：

設(shè)備管理

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

安全

事件處理

用戶(hù)管理

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

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

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

準(zhǔn)備工作一 —— 注冊(cè)nRF cloud 賬號(hào)

打開(kāi)https://nrfcloud.com/#/

點(diǎn)擊Register，填好相關(guān)的信息后確認(rèn)，此時(shí)就注冊(cè)了一個(gè)nRF cloud的開(kāi)發(fā)者（developer）賬號(hào)。

如果想要體驗(yàn)更多的nRF Cloud服務(wù)，如agps輔助定位，wifi定位我們需要將developer賬號(hào)升級(jí)到pro升級(jí)方式如下：

? 進(jìn)入nrf cloud的DASHBOARD界面，點(diǎn)擊頁(yè)面右上角的plan setting選項(xiàng)

? 點(diǎn)擊 Change plan按鈕

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

? 點(diǎn)擊PRO下的upgrade!填寫(xiě)相關(guān)信息，包括公司信息，信用卡卡號(hào)等，即可完成升級(jí)。

準(zhǔn)備工作二—— 安裝rest api工具Postman

根據(jù)以下鏈接安裝POSTMAN并試驗(yàn)發(fā)送請(qǐng)求。

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

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

準(zhǔn)備工作三—— 生成Token

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

API Key 在nRF cloud 賬號(hào)生成的時(shí)候就自帶了，點(diǎn)擊右上角的user account就可以找到。

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

示例

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

獲取設(shè)備信息：

用curl指令使用此API：

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

這條API，類(lèi)型是GET， 認(rèn)證類(lèi)型是Bearer token,Token類(lèi)型是simple token，即API Key,以上指令中緊跟著B(niǎo)earer后的就是nRF CLOUD賬戶(hù)中對(duì)應(yīng)的API Key。

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

通過(guò)WIFI熱點(diǎn)的SSID來(lái)獲取WIFI定位坐標(biāo)

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"}]}

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

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

然后在Header中確認(rèn)選中content type為application/json

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

審核編輯 黃宇