REST es un estándar de servicio web ligero y sin estado que puedes usar en tus productos para llamadas únicas ad-hoc, labs de prueba de concepto, solución de problemas, apps que sondean aproximadamente un minuto y implementaciones de botones de actualización.
La interfaz de REST usa la URL del modelo de datos de la API de Nest como un extremo.
En REST, hay un token de OAuth asignado a una ruta de acceso en el modelo de datos de la API. Cada token se asocia con un solo usuario final. El token significa que un usuario autorizó al desarrollador a acceder a una ruta de acceso en el modelo de datos. La nube de la API de Nest evalúa el token en función de la ruta solicitada y envía un error o envía la información solicitada.
Supongamos que un usuario quiere brindar información sobre el estado de la ocupación de su casa a fin de que se abra la puerta de la cochera cuando llega. Se evalúa un token para obtener el estado En casa y Ausente de la estructura.
Para mantenerse actualizado en el estado de ocupación, se pueden realizar llamadas de REST cada minuto a fin de determinar el estado de En casa o Ausente. La API de Nest evalúa el token y muestra la respuesta. En respuesta a cada llamada, se muestra la información y, luego, se cierra la conexión TCP. Cada llamada genera una conexión TCP nueva.
Ten en cuenta la siguiente información sobre la implementación de Nest:
- El sufijo
.JSONes opcional para los extremos de URL de Nest. - Tus productos deberán administrar redireccionamientos con el código de estado 307.
- Es posible que se aplique el límite de frecuencia de datos a tus productos
No compatibles:
POSTDELETE- Escribir prioridades para la API de REST
- Escribe valores de servidor desde la API de REST
- Recupera y actualiza reglas de seguridad
REST y límites de frecuencia
Para evitar el uso excesivo del servicio de Nest, limitamos la cantidad de tokens con una cantidad limitada de llamadas de lectura/escritura.
Si deseas obtener más información, consulta Límites de frecuencia de datos.
REST y redireccionamientos
Otro aspecto que debes tener en cuenta cuando uses REST es que tu producto también debe incluir redireccionamientos 307.