nest-api - NEST 恒温器 API

Question

我正在尝试使用新发布的 NEST api 开发一个 ios 应用程序，但他们的本机文档有点丢失。

问题：我可以获得访问令牌但不知道恒温器端点来查询和更新“离开”状态

任何指针将不胜感激..

Answer 1

我假设您打算使用 REST 来查询和更新离开状态，因为您提到了“端点”？如果不是，另一种选择是使用 firebase API。这记录在 介绍部分

要获得离开状态，您需要查询结构

curl -v -L https://developer-api.nest.com/structures?auth=<AUTH_TOKEN>

除了该结构中的恒温器/烟雾警报外，响应还显示离开状态。

{
    "g-9y-2xkHpBh1MGkVaqXOGJiKOB9MkoW1hhYyQk2vAunCK8a731jbg": {
        "away": "home",
        "country_code": "US",
        "name": "Home",
        "smoke_co_alarms": [
            "0NBM7-QfoLwhMldZ2CoIkQ7hRJoe1Jye"
        ],
        "structure_id": "g-9y-2xkHpBh1MGkVaqXOGJiKOB9MkoW1hhYyQk2vAunCK8a731jbg",
        "thermostats": [
            "GM6Z9JpSKU6_ua8AfD6WRA"
        ],
        "time_zone": "America/Los_Angeles"
    }
}

要更新离开状态，您需要使用 PUT http 动词：

curl -v -L -X PUT "https://developer-api.nest.com/structures/g-9y-2xkHpBh1MGkVaqXOGJiKOB9MkoW1hhYyQk2vAunCK8a731jbg?auth=<AUTH_TOKEN>" -H "Content-Type: application/json" -d '{"away":"away"}'

请注意，路径参数中使用的 ID 是 get 响应中返回的结构 ID。

希望能帮助纳格什