REST-Übersicht

REST ist ein einfacher, zustandsloser Webdienststandard, den Sie in Ihren Produkten für einmalige Ad-hoc-Aufrufe, Proof of Concept-Labs, Fehlerbehebung, Apps, die etwa alle Minuten abgefragt werden, und die Aktualisierung von Schaltflächen verwenden kann.

Die REST-Schnittstelle verwendet die URL des Nest API-Datenmodells als Endpunkt.

In REST ist ein OAuth-Token einem Pfad im API-Datenmodell zugeordnet. Jedes Token ist einem einzelnen Endnutzer zugeordnet. Das Token bedeutet, dass ein Nutzer den Entwickler autorisiert hat, auf einen Pfad im Datenmodell zuzugreifen. Die Nest API-Cloud vergleicht das Token mit dem angeforderten Pfad und sendet entweder einen Fehler oder sendet die angeforderten Informationen.

Angenommen, ein Nutzer möchte Statusinformationen zur Belegung seines Zuhauses angeben, damit das Garagentor geöffnet wird, wenn der Nutzer nach Hause kommt. Ein Token wird ausgewertet, um den Modus „Zuhause“ und „Abwesend“ der Struktur abzurufen.

REST-Aufrufe können jede Minute ausgeführt werden, um den Status „Zuhause“ oder „Abwesend“ zu ermitteln und so den Belegungsstatus zu aktualisieren. 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 die TCP-Verbindung geschlossen. Mit jedem Aufruf wird eine neue TCP-Verbindung generiert.

Wichtige Hinweise zur Implementierung von Nest:

  • .JSON-Suffix ist für Nest-URL-Endpunkte optional
  • Ihre Produkte müssen Weiterleitungen mit dem Statuscode 307 verarbeiten.
  • Für Ihre Produkte kann eine Datenbegrenzung angewendet werden

Nicht unterstützt:

  • POST
  • DELETE
  • Schreibprioritäten für die REST API
  • Serverwerte aus der REST API schreiben
  • Sicherheitsregeln abrufen und aktualisieren

REST und Ratenbegrenzungen

Um eine Überlastung des Nest-Dienstes zu verhindern, ist die Anzahl der Tokens auf eine begrenzte Anzahl von Lese-/Schreibaufrufen beschränkt.

Weitere Informationen finden Sie unter Ratenbegrenzungen für Daten.

REST und Weiterleitungen

Bei der Verwendung von REST muss Ihr Produkt auch 307-Weiterleitungen verarbeiten können.