Notice: We're retiring Works with Nest. See the home page for more information.
Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

REST概述

REST是一种轻量级,无状态的Web服务标准,您可以在产品中使用它进行即席一次性呼叫,概念验证实验室,故障排除,大约每分钟轮询一次的应用程序以及刷新按钮实现。

REST接口使用Nest API数据模型URL作为端点。

在REST中,有一个OAuth令牌映射到API数据模型中的路径。每个令牌与一个最终用户关联。令牌表示用户已授权开发人员访问数据模型中的路径。 Nest API云会根据请求的路径评估令牌,然后发送错误或发送请求的信息。

假设用户想提供有关其房屋占用的状态信息,以便当用户到达家时车库门打开。评估令牌以获取结构的“归宿”状态。

为了保持有关占用状态的最新信息,可能会每分钟进行一次REST呼叫以确定回家或离开的状态。 Nest API会评估令牌并返回答案。响应每个调用,返回信息,然后关闭TCP连接。每个调用都会生成一个新的TCP连接。

请记住有关Nest实施的以下几点:

不支持:

  • POST
  • DELETE
  • REST API的编写优先级
  • 从REST API写入服务器值
  • 检索和更新安全规则

REST和速率限制

为防止Nest服务的过度利用,我们限制了具有有限数量的读/写调用的令牌数量。

有关更多信息,请参见数据速率限制

REST和重定向

使用REST时的另一个注意事项是您的产品还必须处理307重定向