สถาปัตยกรรมของ Nest API

เกี่ยวกับบริการ Nest

แอปพลิเคชัน Nest ช่วยให้ผู้ใช้เชื่อมต่อกับบ้านได้จากทุกที่ อุปกรณ์ Nest ทั้งหมด (ตัวควบคุมอุณหภูมิ การป้องกัน และกล้อง) และแอปพลิเคชัน (iOS, Android และเว็บแอป) จะเชื่อมต่อกับบริการ Nest

ตัวอย่างจากระบบคลาวด์ไปยังระบบคลาวด์

บริการ Nest มอบโมเดลข้อมูลของบ้าน อุปกรณ์และแอปพลิเคชันจะอ่านจากโมเดลข้อมูลนี้เพื่อดําเนินการอย่างเหมาะสม จากนั้นจะอัปเดตโมเดลข้อมูล เพื่อให้สอดคล้องกับการเปลี่ยนแปลงในระบบ

เช่น ตัวควบคุมอุณหภูมิจะอ่านอุณหภูมิเป้าหมายจากโมเดลข้อมูล ซึ่งจะตั้งค่าอุณหภูมิแวดล้อมเป็นการวัดปัจจุบัน และส่งข้อมูลเซ็นเซอร์ไปยังตัวช่วยเปลี่ยนโหมดอยู่บ้าน/ไม่อยู่บ้าน ซึ่งจะปรับโหมดโครงสร้างตามนั้น

อุปกรณ์ Nest ทํางานในสภาพแวดล้อมที่จํากัด พลังงานมีจํากัดและการเชื่อมต่อเครือข่ายภายในบ้านไม่น่าเชื่อถือ ผลิตภัณฑ์และบริการของคุณอาจใช้ประโยชน์จาก อัลกอริทึมของอุปกรณ์เพื่อมอบประสบการณ์ที่บ้านที่ใช้งานง่าย

รูปแบบข้อมูล

Nest API จะแสดงเป็นเอกสาร JSON ที่มีแอตทริบิวต์ระดับบนสุดเป็น metadata, devices และ structures ผลิตภัณฑ์ Works with Nest ใช้เอกสาร JSON นี้เพื่อโต้ตอบและโต้ตอบกับอุปกรณ์ Nest และการเปลี่ยนแปลงสถานะที่เกี่ยวข้อง

Nest structures นําเสนอโครงสร้างทางกายภาพในชีวิตจริง หน้านี้ทําหน้าที่เป็นจุดจัดระเบียบของ devices และจัดเก็บข้อมูลสําหรับทั้งอาคาร โดยปกติแล้ว structure จะเป็นบ้านของผู้ใช้

Nest devices แสดงถึงอุปกรณ์จริง (ตัวควบคุมอุณหภูมิ อุปกรณ์ป้องกัน และกล้อง) ภายในโครงสร้าง

องค์ประกอบข้อมูลทั้งหมดในเอกสาร JSON จะจัดการได้ผ่าน URL (หรือที่เรียกว่า "ตําแหน่งข้อมูล") ผลิตภัณฑ์ Works with Nest จะอ่านและเขียนส่วนต่างๆ ของเอกสารนี้ รวมทั้งสมัครรับการเปลี่ยนแปลงได้ ความสามารถในการสมัครใช้บริการนี้ช่วยให้ผลิตภัณฑ์ Works with Nest ตอบสนองแบบเรียลไทม์กับการเปลี่ยนแปลงที่เกิดขึ้นกับระบบได้ เช่น การปิดไฟเมื่อผู้ใช้ตั้งค่าโครงสร้างเป็น "ไม่อยู่บ้าน"

นอกจากนี้ ออบเจ็กต์ยังทํางานภายใต้ข้อจํากัดในโลกแห่งความเป็นจริงด้วย โมเดลข้อมูลจะปกป้องอุปกรณ์และบ้านของผู้ใช้โดยป้องกันการดําเนินการที่ไม่คาดคิดและเป็นอันตราย เช่น ตัวควบคุมอุณหภูมิจะไม่ปรับอากาศเมื่อเปิดใช้แหล่งความร้อนฉุกเฉิน

สํารวจโมเดลข้อมูลด้วยข้อมูลอ้างอิง API แบบอินเทอร์แอกทีฟนี้

สถานะที่ต้องการ

บริการ Nest จะจัดเก็บสถานะที่เชื่อถือได้ของระบบ และผลิตภัณฑ์ Works with Nest จะสมัครรับการเปลี่ยนแปลง การแก้ไขสถานะนี้ (เช่น การเปลี่ยนแปลงอุณหภูมิเป้าหมายของตัวควบคุมอุณหภูมิ) จะทําให้บริการพุชการแจ้งเตือนการเปลี่ยนแปลงไปยังผู้ติดตามทุกคน

การเผยแพร่อาจล่าช้าและเครือข่ายไม่เสถียร สถานะที่ผลิตภัณฑ์แจ้งให้ทราบอาจไม่ใช่สถานะที่ผลิตภัณฑ์อื่นๆ หรือบริการพบ จะมีการซิงค์สถานะในที่สุดเมื่อส่งข้อความ ระหว่างผลิตภัณฑ์ต่างๆ

โมเดลการเผยแพร่/สมัครรับข้อมูลเอกสารนี้มีการโต้ตอบของแอปพลิเคชันที่ปรับเปลี่ยนตามอุปกรณ์

การใช้บริการ Nest

หากต้องการเข้าถึงปลายทาง REST ในบริการ Nest ให้ใช้ HTTPS ในผลิตภัณฑ์ มีไลบรารีของไคลเอ็นต์ของบุคคลที่สามจํานวนมากที่ใช้เพื่อจุดประสงค์นี้ได้

สิทธิ์และการให้สิทธิ์

เราต้องการให้นักพัฒนาซอฟต์แวร์สร้างผลิตภัณฑ์และบริการที่ทําให้บ้านดีขึ้นโดยไม่ส่งผลกระทบต่อความเป็นส่วนตัวและความปลอดภัยของผู้ใช้ การสื่อสารทั้งหมดของเราปลอดภัยและผู้ใช้จะได้รับสิทธิ์เข้าถึงอย่างชัดแจ้งเสมอ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมสิทธิ์

การให้สิทธิ์ได้รับการจัดการโดยโปรโตคอล OAuth 2.0 เมื่อผู้ใช้ตกลงที่จะให้สิทธิ์เข้าถึงระดับการเข้าถึงที่ขอ Nest จะตรวจสอบคําขอและมอบโทเค็นเพื่อการเข้าถึงให้ผู้ขอ คุณจะใช้โทเค็นเพื่อการเข้าถึงดังกล่าวเพื่อเข้าถึง Nest API และโต้ตอบกับโครงสร้างและอุปกรณ์ของผู้ใช้ได้

การให้สิทธิ์เข้าถึงแก่โทเค็นจะสร้างความสัมพันธ์ที่เชื่อถือได้ระหว่างผู้ใช้, ผลิตภัณฑ์ Works with Nest และ Nest ผู้ใช้เพิกถอนการเข้าถึงได้ทุกเมื่อ

หากต้องการดูวิธีให้สิทธิ์การเชื่อมต่อกับ Nest API โปรดดูภาพรวมการให้สิทธิ์