Notice: We're retiring Works with Nest. See the home page for more information.
O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Visão geral do REST

REST é um padrão de serviço web leve e sem estado que você pode usar em seus produtos para chamadas pontuais ad-hoc, laboratórios de prova de conceito, solução de problemas, aplicativos que pesquisam aproximadamente a cada minuto e implementações de botão de atualização.

A interface REST usa a URL do modelo de dados da API Nest como um terminal.

No REST, há um token OAuth mapeado para um caminho no modelo de dados da API. Cada token está associado a um único usuário final. O token significa que um usuário autorizou o desenvolvedor a acessar um caminho no modelo de dados. A nuvem Nest API avalia o token em relação ao caminho solicitado e envia um erro ou as informações solicitadas.

Suponha que um usuário queira fornecer informações de status sobre a ocupação de sua casa para que a porta da garagem abra quando o usuário chegar em casa. Um token é avaliado para obter o estado Home & Away da estrutura.

Para se manter atualizado sobre o estado de ocupação, chamadas REST podem ser feitas a cada minuto para determinar o status de casa ou de ausência. A API Nest avalia o token e retorna a resposta. Em resposta a cada chamada, as informações são retornadas e a conexão TCP é fechada. Cada chamada gera uma nova conexão TCP.

Lembre-se dos seguintes pontos sobre a implementação da Nest:

Não suportado:

  • POST
  • DELETE
  • Escrevendo prioridades para a API REST
  • Gravando valores de servidor da API REST
  • Recuperando e atualizando regras de segurança

REST e limites de taxa

Para evitar a superutilização do serviço Nest, limitamos o número de token com um número limitado de chamadas de leitura / gravação.

Para obter mais informações, consulte Limites de taxa de dados .

REST e redirecionamentos

Outra consideração ao usar REST é que seu produto também deve lidar com redirecionamentos 307 .