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

REST-Übersicht

REST ist ein einfacher, zustandsloser Webservice-Standard, den Sie in Ihren Produkten für einmalige Ad-hoc-Anrufe, Proof-of-Concept-Labs, Fehlerbehebung, Apps, die ungefähr jede Minute abfragen, und Implementierungen von Aktualisierungsschaltflächen verwenden können.

Das REST - Schnittstelle verwendet das Nest API Data Model URL als Endpunkt.

In REST ist ein OAuth-Token einem Pfad im API-Datenmodell zugeordnet. Jedes Token ist einem einzelnen Endbenutzer zugeordnet. Das Token bedeutet, dass ein Benutzer den Entwickler autorisiert hat, auf einen Pfad im Datenmodell zuzugreifen. Die Nest API-Cloud wertet das Token gegen den angeforderten Pfad aus und sendet entweder einen Fehler oder sendet die angeforderten Informationen.

Angenommen, ein Benutzer möchte Statusinformationen über die Belegung seines Hauses bereitstellen, damit sich das Garagentor öffnet, wenn der Benutzer nach Hause kommt. Ein Token wird ausgewertet, um den Heimat- und Abwesend-Status der Struktur zu erhalten.

Um über den Belegungsstatus auf dem Laufenden zu bleiben, können jede Minute REST-Anrufe getätigt werden, um den Heimat- oder Abwesenheitsstatus zu ermitteln. Die Nest API wertet das Token aus und gibt die Antwort zurück. Als Antwort auf jeden Aufruf werden die Informationen zurückgegeben und dann wird die TCP-Verbindung geschlossen. Jeder Aufruf erzeugt eine neue TCP-Verbindung.

Beachten Sie bei der Implementierung von Nest die folgenden Punkte:

Nicht unterstützt:

  • POST
  • DELETE
  • Prioritäten für die REST-API schreiben
  • Schreiben von Serverwerten aus der REST-API
  • Abrufen und Aktualisieren von Sicherheitsregeln

REST- und Ratenlimits

Um eine Übernutzung des Nest-Dienstes zu verhindern, beschränken wir die Anzahl der Token mit einer begrenzten Anzahl von Lese-/Schreibaufrufen.

Weitere Informationen finden Sie Data Rate Limits .

REST und Weiterleitungen

Eine weitere Überlegung bei dem REST ist , dass Ihr Produkt auch behandeln muß 307 Umleitungen .