NEST恒温器API

时间:2014-06-28 02:44:52

标签: nest-api

我正在尝试使用新发布的NEST api开发一个ios应用程序,但在本机文档中丢失了一些。

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

任何指针都将非常感谢..

1 个答案:

答案 0 :(得分:2)

我假设您打算使用REST来查询和更新离开状态,因为您提到了"端点"?如果不是,则另一种方法是使用firebase API。这在introduction section

中有记录

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

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

请注意,path参数中使用的ID是get响应中返回的结构ID。

希望有所帮助 纳格什