Google is committed to advancing racial equity for Black communities. See how.

Présentation de REST

REST est une norme de service Web légère et sans état que vous pouvez utiliser dans vos produits pour les appels ponctuels ad hoc, les laboratoires de validation de principe, le dépannage, les applications qui interrogent environ toutes les minutes et les implémentations de boutons d'actualisation.

L'interface REST utilise l' API Nest Data Model URL comme critère d'évaluation.

Dans REST, il existe un jeton OAuth mappé à un chemin dans le modèle de données de l'API. Chaque token est associé à un seul utilisateur final. Le jeton signifie qu'un utilisateur a autorisé le développeur à accéder à un chemin dans le modèle de données. Le cloud de l'API Nest évalue le jeton par rapport au chemin demandé et envoie une erreur ou envoie les informations demandées.

Supposons qu'un utilisateur souhaite fournir des informations d'état sur l'occupation de sa maison afin que la porte du garage s'ouvre lorsque l'utilisateur arrive chez lui. Un jeton est évalué pour obtenir l'état Home & Away de la structure.

Pour rester à jour sur l'état d'occupation, des appels REST peuvent être effectués toutes les minutes pour déterminer l'état d'accueil ou d'absence. L'API Nest évalue le jeton et renvoie la réponse. En réponse à chaque appel, les informations sont renvoyées puis la connexion TCP est fermée. Chaque appel génère une nouvelle connexion TCP.

Gardez à l'esprit les points suivants concernant la mise en œuvre de Nest :

  • .JSON suffixe est facultatif pour les points d'extrémité URL Nest
  • Vos produits devront gérer réoriente avec le code d'état 307
  • Débit de données limite peut être appliquée à vos produits

Non supporté:

  • POST
  • DELETE
  • Écriture des priorités pour l'API REST
  • Écrire des valeurs de serveur à partir de l'API REST
  • Récupérer et mettre à jour les règles de sécurité

REST et limites de débit

Pour éviter une surutilisation du service Nest, nous limitons le nombre de jetons à un nombre limité d'appels en lecture/écriture.

Pour plus d' informations, voir les limites Data Rate .

REST et redirections

Une autre considération lors de l' utilisation REST est que votre produit doit également gérer 307 réoriente .