MQTT API 文件

X-平台使用AWS MQTT broker（AWS IoT），使用者可以參考AWS MQTT文件來了解如何透過MQTT API來將資料送至平台，在AWS文件中提供了不同種程式語言的範例程式可供參考。

以下將以資料格式頁內，所設定的資料（FactoryA）為例子來說明。

憑證及金鑰

在範例程式中將會需要憑證及端點，可以下方圖中右上角紅色圓圈找到，點擊憑證將下載檔案，解壓縮後，將得到憑證相關檔案及金鑰。

Topic

見上面圖示中紫色圓圈中為Topic，每個資料來源將有自己的topic，其組成為「{使用者ID}/{資料來源}」。使用者ID為上圖灰色塗改處可在平台上MQTT API文件頁面中找到，每個使用者有不同的ID。

使用Curl

以下為一簡單範例，需將{端點}、{topic}、和{data}替換成平台提供的資料，{data}的格式為"{ \"message\": \"Hello, world\" }"。

curl --tlsv1.2 \
    --cacert AmazonRootCA1.pem \
    --cert certificate.pem.crt \
    --key private.pem.key \
    --request POST \
    --data {data} \
    "https://{端點}:8443/topics/{topic}?qos=1"

注意：針對物聯網的硬體來說，如果硬體或IC設計廠商有支援AWS MQTT，也可根據廠商提供文件將資料送至X-平台。