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

ข้อความแสดงข้อผิดพลาด

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

เมื่อมีข้อผิดพลาดเกิดขึ้นระหว่างการเรียก API การตอบสนองในรูปแบบนี้จะถูกส่งไป:

{
  "error": "Temperature '$temp' is in wrong format",
  "type": "https://developers.nest.com/documentation/cloud/error-messages#format-error",
  "message": "Temperature '$temp' is in wrong format",
  "instance": "31441a94-ed26-11e4-90ec-1681e6b88ec1",
  "details": {
    "field_name": "$temp"
  }
}

ข้อความผิดพลาดทั้งหมดมี error , type , message และ instance สาขา details วัตถุเป็นตัวเลือก

ฟิลด์ คำอธิบาย
error รูปแบบข้อความแสดงข้อผิดพลาดสั้น ๆ
type ระบุ URL ไปยังข้อมูลโดยละเอียดเกี่ยวกับเงื่อนไขข้อผิดพลาด (หน้านี้)
message รูปแบบข้อความแสดงข้อผิดพลาดแบบยาวที่อาจใช้ตัวแปรเพื่อให้รายละเอียดเพิ่มเติม เมื่อตัวแปรจะรวมอยู่ในข้อความจะปรากฏใน details วัตถุ
instance สตริงข้อความที่มีตัวระบุข้อผิดพลาดที่ไม่ซ้ำกันสำหรับการโทรแต่ละครั้ง เราอาจขอหมายเลขอินสแตนซ์จากคุณหากคุณรายงานปัญหาเกี่ยวกับบริการ
details ไม่จำเป็น. มีตัวแปรที่จะแทรกลงใน message ข้อความสามารถมีได้หลายตัวแปร

สำหรับข้อมูลเกี่ยวกับข้อผิดพลาดที่ไม่เกี่ยวข้องกับ Nest API ให้ดู รหัสข้อผิดพลาดอื่น ๆ และข้อความ

ถูกบล็อค

ขีด จำกัด ของอัตราการ ได้รับเกิน

พารามิเตอร์
HTTP รหัสสถานะ: 429 จองมากเกินไป
error ถูกบล็อก
type https://developers.nest.com/reference/error-messages#blocked
message ถูกบล็อก

ไม่สามารถเปิดใช้งานพัดลมระหว่างการปิดระบบควัน/ความปลอดภัยร่วม

ฉุกเฉิน shutoff มีผล ไม่ยอมรับการเรียก API จนกว่าจะมีการกู้คืนการทำงานปกติ

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถเปิดใช้งานพัดลมระหว่างการปิดระบบควัน/ความปลอดภัยร่วม
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message ไม่สามารถเปิดใช้งานพัดลมระหว่างการปิดระบบควัน/ความปลอดภัยร่วม

ไม่สามารถเปลี่ยนสถานะไม่อยู่ได้ในขณะที่เปิดระบบทำความร้อนฉุกเฉินอยู่

ผลิตภัณฑ์ที่พยายามที่จะเปลี่ยนสถานะไปในขณะที่ ความร้อนฉุกเฉิน อยู่บน

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถเปลี่ยนสถานะไม่อยู่ได้ในขณะที่เปิดระบบทำความร้อนฉุกเฉินอยู่
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message ไม่สามารถเปลี่ยนสถานะไม่อยู่ได้ในขณะที่เปิดระบบทำความร้อนฉุกเฉินอยู่

ไม่สามารถเปลี่ยนโหมด HVAC ระหว่างกิจกรรมประหยัดพลังงาน

เหตุการณ์การประหยัดพลังงาน ที่กำหนดโดยพันธมิตรพลังงาน Nest มีผล การเรียก API จะถูกปฏิเสธจนกว่ากิจกรรมการประหยัดพลังงานจะสิ้นสุดลง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถเปลี่ยนโหมด HVAC ระหว่างกิจกรรมประหยัดพลังงาน
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message ไม่สามารถเปลี่ยนโหมด HVAC ระหว่างกิจกรรมประหยัดพลังงาน

ไม่สามารถเปลี่ยนโหมด HVAC ได้

โหมดนี้เข้ากันไม่ได้กับคำขอ

ตัวอย่างเช่น คุณอาจได้รับข้อความนี้หาก:

  • ระบบ HVAC ของเทอร์โมไม่สนับสนุนโหมดที่ร้องขอโดยผลิตภัณฑ์ของคุณ: heat , cool , heat-cool หรือ eco
  • โหมด HVAC จะถูกกำหนดให้ eco และพยายามผลิตภัณฑ์ชุด target_temperature
พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถเปลี่ยนโหมด HVAC ไป $mode ; HVAC ไม่สามารถ $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message ไม่สามารถเปลี่ยนโหมด HVAC ไป $mode ; HVAC ไม่สามารถ $action
details $mode
$action

ไม่สามารถเปลี่ยนโหมด HVAC ขณะเปิดใช้งานการล็อกตัวควบคุมอุณหภูมิ

ผู้ใช้จะต้อง ปลดล็อคเทอร์โม ก่อนที่สินค้าจะสามารถเขียนข้อมูล

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถเปลี่ยนโหมด HVAC ขณะเปิดใช้งานการล็อกตัวควบคุมอุณหภูมิ
type https://developers.nest.com/reference/error-messages#lock-enabled
message ไม่สามารถเปลี่ยนโหมด HVAC ขณะเปิดใช้งานการล็อกตัวควบคุมอุณหภูมิ

ไม่สามารถตั้งอุณหภูมิ C และ F พร้อมกันได้

ผลิตภัณฑ์พยายามตั้งอุณหภูมิเป้าหมายทั้งเซลเซียสและฟาเรนไฮต์พร้อมกัน ผลิตภัณฑ์ควรตั้งอุณหภูมิเพียงเป้าหมายที่ระบุโดย temperature_scale (C / F)

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถตั้งอุณหภูมิ C และ F พร้อมกันได้
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message ไม่สามารถตั้งอุณหภูมิ C และ F พร้อมกันได้

ไม่สามารถตั้งค่าเปิด/ปิด fan_timer_active เนื่องจากโหมดที่เข้ากันไม่ได้

พัดลมระบบ HVAC ทำงานอยู่แล้ว (ทั้งผู้ใช้เองหรือตามกำหนดเวลา หรือเนื่องจากรอบการทำความร้อน/ความเย็นของ HVAC)

หากคุณไม่ได้รับผลลัพธ์ที่คาดหวัง เป็นไปได้มากว่าอุปกรณ์มีการทำงานในตัวที่เราไม่สามารถแทนที่ผ่าน API ได้

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถตั้งค่า fan_timer_active / ปิดเนื่องจากโหมดที่เข้ากันไม่ $mode
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message ไม่สามารถตั้งค่า fan_timer_active / ปิดเนื่องจากโหมดที่เข้ากันไม่ $mode
details $mode

ไม่สามารถตั้งค่า fan_timer_duration เป็นค่าที่เลือก

ผลิตภัณฑ์ที่พยายามที่จะชุด fan_timer_duration เป็นค่าที่ไม่ถูกต้อง ดู fan_timer_duration สำหรับรายการของค่าที่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถตั้งค่า fan_timer_duration เป็นค่าที่เลือก ดูการอ้างอิง API สำหรับค่าที่อนุญาต
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message ไม่สามารถตั้งค่า fan_timer_duration เป็นค่าที่เลือก ดูการอ้างอิง API สำหรับค่าที่อนุญาต

ไม่สามารถตั้งเป้าหมายอุณหภูมิต่ำให้สูงกว่าเป้าหมายที่อุณหภูมิสูงได้

เทอร์โมอยู่ใน heat-cool โหมดและสินค้าความพยายามที่จะกำหนดเป้าหมายอุณหภูมิต่ำ / สูงที่อยู่นอกช่วง ยกตัวอย่างเช่นผลิตภัณฑ์ที่พยายามที่จะชุด target_temperature_low_c ถึง 25 ° C เมื่อ target_temperature_high_c 24 ° C

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถกำหนดเป้าหมายอุณหภูมิต่ำ $lowTemp สูงกว่าเป้าหมายที่มีอุณหภูมิสูง $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message ไม่สามารถกำหนดเป้าหมายอุณหภูมิต่ำ $lowTemp สูงกว่าเป้าหมายที่มีอุณหภูมิสูง $highTemp
details $lowTemp
$highTemp

ไม่สามารถตั้งอุณหภูมิเป้าหมายให้ใกล้กว่า N องศา C/F

ผลิตภัณฑ์ที่พยายามที่จะกำหนดค่าอุณหภูมิเป้าหมายใกล้เกินไปที่จะสูงเป้าหมายอุณหภูมิ / ต่ำ (เช่น target_temperature_high_f )

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถตั้งอุณหภูมิเป้าหมายให้ใกล้กว่า N องศา C/F
type https://developers.nest.com/reference/error-messages#range-error
message ไม่สามารถตั้งค่าอุณหภูมิเป้าหมายใกล้กว่า $min องศา $scale
details $min
$scale

ไม่สามารถตั้งค่า target_temperature ในขณะที่โหมดคือ $mode

ตัวควบคุมอุณหภูมิหรือโครงสร้างอยู่ในโหมดที่ไม่รองรับคำขอ API

ตัวอย่างเช่นคุณไม่สามารถตั้ง target_temperature_f หรือ target_temperature_c เมื่อระบบ HVAC คือ off หรือ heat-cool โหมด ค่าจะเปลี่ยนไม่ได้จนกว่าตัวควบคุมอุณหภูมิ/โครงสร้างจะเปลี่ยนกลับเป็นโหมดที่ไม่จำกัด

ในข้อความนี้ $fieldName สามารถใด ๆ ของค่าอุณหภูมิเป้าหมายและ $mode สามารถใด ๆ ของ: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถตั้งค่า target_temperature ขณะที่โหมด $mode
type https://developers.nest.com/reference/error-messages#mode-error
message ไม่สามารถตั้งค่า $fieldName ในขณะที่โหมด $mode
details $fieldName
$mode

จำเป็นต้องอัปเดตเฟิร์มแวร์ของอุปกรณ์ก่อนที่คุณจะสามารถเปลี่ยนโหมด HVAC ได้

อุปกรณ์ต้องได้รับการอัปเดตเป็นเวอร์ชันเฟิร์มแวร์ปัจจุบันเพื่อตั้งค่า Eco Temperatures

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error จำเป็นต้องอัปเดตเฟิร์มแวร์ของอุปกรณ์ก่อนที่คุณจะสามารถเปลี่ยนโหมด HVAC ได้ การอัปเดตเป็นไปโดยอัตโนมัติ โดยปกติภายในหนึ่งสัปดาห์หลังจากเผยแพร่
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message จำเป็นต้องอัปเดตเฟิร์มแวร์ของอุปกรณ์ก่อนที่คุณจะสามารถเปลี่ยนโหมด HVAC ได้ การอัปเดตเป็นไปโดยอัตโนมัติ โดยปกติภายในหนึ่งสัปดาห์หลังจากเผยแพร่

เกิดข้อผิดพลาดขณะตรวจสอบฟิลด์ WWN

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ข้อผิดพลาดในขณะที่การตรวจสอบเขต WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message ข้อผิดพลาดในขณะที่การตรวจสอบเขต WWN: $error
details $error

ETA อยู่ในอดีต

เวลา ETA ที่ระบุเป็นเวลาที่ผ่านมาแล้ว (ก่อน NOW) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการโทรกทพ. ให้ดู ออกไปและการทางพิเศษแห่งประเทศไทยคู่มือ

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error การทางพิเศษแห่งประเทศไทยอยู่ในอดีตที่ผ่านมา: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message การทางพิเศษแห่งประเทศไทยอยู่ในอดีตที่ผ่านมา: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA อยู่ไกลเกินไปในอนาคต

เวลา ETA ที่ระบุจะต้องไม่เกิน 8 ชั่วโมงในอนาคต สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการโทรกทพ. ให้ดู ออกไปและการทางพิเศษแห่งประเทศไทยคู่มือ

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ETA อยู่ไกลเกินไปในอนาคต
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA อยู่ไกลเกินไปในอนาคต

fan_timer_active ไม่ได้ตั้งค่า

fan_timer_active ไม่ได้กำหนดไว้

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error fan_timer_active ไม่ได้ตั้งค่า
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active ไม่ได้ตั้งค่า

ต้องห้าม

ข้อมูลประจำตัวที่ใช้เพื่อเข้าถึงบริการ Nest ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 403 พระราชวังต้องห้าม
error ต้องห้าม
type https://developers.nest.com/reference/error-messages#forbidden
message ต้องห้าม

ข้อผิดพลาดภายใน

พารามิเตอร์
สถานะ HTTP รหัส: ข้อผิดพลาด 500 เซิร์ฟเวอร์ภายใน
error ข้อผิดพลาดภายใน
type https://developers.nest.com/reference/error-messages#internal-error
message ข้อผิดพลาดภายใน

ID กล้องไม่ถูกต้อง

camera-id ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error กล้องไม่ถูกต้องรหัส $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message กล้อง ID ไม่ถูกต้อง: $id
details $id

ส่งเนื้อหาที่ไม่ถูกต้อง

การโทรมีเนื้อหาที่ไม่ถูกต้อง ตัวอย่างเช่น การใช้ "ใช่" แทน "จริง" สำหรับตัวแปรบูลีน

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ส่งเนื้อหาที่ไม่ถูกต้อง
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message ส่งเนื้อหาที่ไม่ถูกต้อง

เส้นทางชิ้นส่วนไม่ถูกต้อง

ส่วนหนึ่งของเส้นทางคำขอไม่ถูกต้อง ตัวอย่างเช่น ชื่ออ็อบเจ็กต์หรือฟิลด์อาจสะกดผิด

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error เส้นทางส่วนไม่ถูกต้อง: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message เส้นทางส่วนไม่ถูกต้อง: $requestPath
details $requestPath

โหมด HVAC ไม่ถูกต้อง

เทอร์โมของระบบ HVAC ไม่สนับสนุนโหมดที่ร้องขอโดยผลิตภัณฑ์: heat , cool หรือ heat-cool

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โหมด HVAC ไม่ถูกต้อง: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message โหมด HVAC ไม่ถูกต้อง: $mode
details $mode

ID สัญญาณเตือนควัน+ร่วมไม่ถูกต้อง

smoke_co_alarm_id ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ควันที่ไม่ถูกต้อง + ร่วมปลุก ID $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message ควัน + ร่วมปลุกรหัสไม่ถูกต้อง: $id
details $id

ID โครงสร้างไม่ถูกต้อง

structure_id ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โครงสร้างที่ไม่ถูกต้องรหัส $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message ID โครงสร้างไม่ถูกต้อง: $id
details $id

ID ตัวควบคุมอุณหภูมิไม่ถูกต้อง

thermostat_id ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error เทอร์โมไม่ถูกต้องรหัส $id
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message เทอร์โมรหัสไม่ถูกต้อง: $id
details $id

ค่า Away A ไม่ถูกต้อง

คุณพยายามที่จะตั้งค่าไม่ถูกต้องสำหรับการ away

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่าไม่ถูกต้องสำหรับทีมเยือน
type https://developers.nest.com/reference/error-messages#invalid-away-value
message ค่าไม่ถูกต้อง: $value อนุญาตให้ใช้เฉพาะค่า 'เจ้าบ้าน' และ 'ทีมเยือน'
details $value

is_streaming ไม่ใช่บูลีน

ผลิตภัณฑ์ที่พยายามที่จะตั้ง is-streaming ข้อมูลที่ไม่ใช่แบบบูล

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error is_streaming ไม่ใช่บูลีน
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming ไม่ใช่บูลีน

ป้ายกำกับต้องมีอักขระน้อยกว่า 256 ตัว

ผลิตภัณฑ์ที่พยายามที่จะสร้าง ป้ายชื่อเทอร์โม ที่มีมากกว่า 256 ตัวอักษร

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ฉลากต้องน้อยกว่า $max_label_length ตัวอักษร
type https://developers.nest.com/reference/error-messages#max-label-length
message ฉลากต้องน้อยกว่า $max_label_length ตัวอักษร
details $max_label_length

กำหนดเองสูงสุดที่เกินจำนวน

ผลิตภัณฑ์ที่พยายามที่จะสร้างที่กำหนดเอง wheres วัตถุเกินสูงสุด จำนวนสูงสุดของการกำหนดเอง wheres วัตถุได้รับอนุญาตเป็น 32

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error เองสูงสุดที่นับ $max_where_count เกิน
type https://developers.nest.com/reference/error-messages#max-where-count
message เองสูงสุดที่นับ $max_where_count เกิน
details $max_where_count

กำหนดเองสูงสุดโดยที่ชื่อยาวเกิน

ที่ name ยาวเกินไป เราขอแนะนำให้ใช้อักขระน้อยกว่า 30 ตัว

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error เองสูงสุดที่ระยะเวลาในชื่อของ $max_custom_where_name_length เกิน
type https://developers.nest.com/reference/error-messages#max-where-name-length
message เองสูงสุดที่ระยะเวลาในชื่อของ $max_custom_where_name_length เกิน
details $max_custom_where_name_length

ขาดช่อง

การเรียกไม่มีพารามิเตอร์ที่จำเป็น

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ข้อมูลที่ขาดหายไป: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message ข้อมูลที่ขาดหายไป: $fieldName
details $fieldName

หายไปที่ไหนID

where_id รูปแบบจะหายไป

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error รหัสหายไปที่ไหน
type https://developers.nest.com/reference/error-messages#where-id-missing
message รหัสหายไปที่ไหน

ไม่มีพัดลม HVAC

ระบบ HVAC ไม่มีพัดลมอิสระ

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่มีพัดลม hvac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message ไม่มีพัดลม hvac

ไม่มีตัวควบคุมอุณหภูมิออนไลน์

ตัวควบคุมอุณหภูมิออฟไลน์อยู่ หลังจากเปิดใช้งาน Wi-Fi ผลิตภัณฑ์ของคุณควรเข้าถึงได้อีกครั้ง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่มีตัวควบคุมอุณหภูมิออนไลน์
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message ไม่มีตัวควบคุมอุณหภูมิออนไลน์

ไม่มีอุปกรณ์ที่จับคู่

อุปกรณ์ Nest ของผู้ใช้จะ ไม่ได้จับคู่กับบัญชี Nest ของผู้ใช้

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่มีอุปกรณ์ที่จับคู่
type https://developers.nest.com/reference/error-messages#no-paired-devices
message ไม่มีอุปกรณ์ที่จับคู่

ไม่มี ETA ที่ถูกต้องในการยกเลิก

การเดินทางไม่ถูกต้องและไม่สามารถยกเลิกได้

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่มี ETA ที่ถูกต้องในการยกเลิก
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message ไม่มี ETA ที่ถูกต้องในการยกเลิก

ไม่มีสิทธิ์เขียนสำหรับฟิลด์

ไคลเอ็นต์ไม่ได้รับอนุญาตให้เขียนข้อมูลนี้ สำหรับข้อมูลเพิ่มเติมโปรดดูที่ การอนุญาตภาพรวม

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่มีสิทธิ์ในการเขียน (s) สำหรับฟิลด์ (s): $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message ไม่มีสิทธิ์ในการเขียน (s) สำหรับฟิลด์ (s): $fields
details $fields

ไม่ใช่ประเภทคำขอที่ถูกต้อง

ประเภทคำขอไม่ถูกต้อง ตัวอย่างเช่น การโทรแบบ POST เกิดขึ้นเมื่อต้องการ PUT

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่ได้เป็นประเภทคำขอที่ถูกต้อง: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message ไม่ได้เป็นประเภทคำขอที่ถูกต้อง: $requestType
details $requestType

ไม่พบ

การโทรพยายามอ่านเส้นทางที่ไม่มีอยู่

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 404 ไม่พบ
error ไม่พบ
type https://developers.nest.com/reference/error-messages#not-found
message ไม่พบ

ไม่อยู่ในโหมดไม่อยู่

โครงสร้างไม่อยู่ในโหมดไม่อยู่เมื่อมีการโทร ETA การทางพิเศษแห่งประเทศไทย โทรได้รับการยอมรับเฉพาะเมื่อโครงสร้างเป็นชุดที่จะออกไป

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่อยู่ในโหมดไม่อยู่
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message ไม่อยู่ในโหมดไม่อยู่

เขียนไม่ได้

ฟิลด์ที่คุณพยายามเขียนถึงเป็นแบบอ่านอย่างเดียว

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error เขียนไม่ได้
type https://developers.nest.com/reference/error-messages#not-writable
message เขียนไม่ได้

ต้องระบุชื่อเท่านั้น

เขตพิเศษถูกรวมอยู่ใน wheres โทร

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ต้องระบุชื่อเท่านั้น
type https://developers.nest.com/reference/error-messages#extra-fields
message ต้องระบุชื่อเท่านั้น

POST ไม่ใช่ประเภทคำขอที่ถูกต้อง

ประเภทคำขอไม่ถูกต้อง ตัวอย่างเช่น การโทรแบบ POST เกิดขึ้นเมื่อต้องการ PUT

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error POST ไม่ใช่ประเภทคำขอที่ถูกต้อง
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST ไม่ใช่ประเภทคำขอที่ถูกต้อง

การละเมิดสคีมา

เกิดข้อผิดพลาดขณะจับคู่อุปกรณ์

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error การละเมิดสคีมา
type https://developers.nest.com/reference/error-messages#schema-violation-error
message การละเมิดสคีมา

ไม่สามารถให้บริการได้

พารามิเตอร์
HTTP สถานะรหัสสินค้า: 503 บริการไม่พร้อมใช้งาน
error ไม่สามารถให้บริการได้
type https://developers.nest.com/reference/error-messages#service-unavailable
message ไม่สามารถให้บริการได้

โครงสร้างมีจำนวนอุปกรณ์ที่จับคู่สูงสุดที่อนุญาตแล้ว

โครงสร้างมีอยู่แล้ว จำนวนสูงสุดของอุปกรณ์ที่ได้รับอนุญาต

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โครงสร้างมีจำนวนอุปกรณ์ที่จับคู่สูงสุดที่อนุญาตแล้ว
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message โครงสร้างมีจำนวนอุปกรณ์ที่จับคู่สูงสุดที่อนุญาตแล้ว

โครงสร้างไม่ได้เป็นเจ้าของโดยผู้ใช้

structure_id ไม่ตรงกับบัญชีผู้ใช้ของการบันทึก

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โครงสร้างไม่ได้เป็นเจ้าของโดยผู้ใช้
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message โครงสร้างไม่ได้เป็นเจ้าของโดยผู้ใช้

อุณหภูมิ C สูงเกินไปสำหรับอุณหภูมิล็อค

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

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error อุณหภูมิ C $tempC สูงเกินไปสำหรับอุณหภูมิล็อค $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message อุณหภูมิ C $tempC สูงเกินไปสำหรับอุณหภูมิล็อค $highLockTemp
details $tempC
$highLockTemp

อุณหภูมิ C ต่ำเกินไปสำหรับอุณหภูมิล็อค

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

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error อุณหภูมิ C $tempC อยู่ในระดับต่ำเกินไปสำหรับอุณหภูมิล็อค $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message อุณหภูมิ C $tempC อยู่ในระดับต่ำเกินไปสำหรับอุณหภูมิล็อค $lowLockTemp
details $tempC
$lowLockTemp

ค่าอุณหภูมิ C สูงเกินไป

ผลิตภัณฑ์พยายามตั้งค่าอุณหภูมิเป้าหมายที่สูงเกินไปสำหรับอุณหภูมิเซลเซียส สำหรับการได้รับอนุญาตช่วงอุณหภูมิในเซลเซียสดู target_temperature_c

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่า C อุณหภูมิสูงเกินไป: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message ค่า C อุณหภูมิสูงเกินไป: $tempC
details $tempC

ค่าอุณหภูมิ C ต่ำเกินไป

ผลิตภัณฑ์พยายามตั้งค่าอุณหภูมิเป้าหมายที่ต่ำเกินไปสำหรับอุณหภูมิเซลเซียส สำหรับการได้รับอนุญาตช่วงอุณหภูมิในเซลเซียสดู target_temperature_c

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่า C อุณหภูมิต่ำเกินไป: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message ค่า C อุณหภูมิต่ำเกินไป: $tempC
details $tempC

อุณหภูมิ F สูงเกินไปสำหรับอุณหภูมิล็อค

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

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error อุณหภูมิ F $tempF สูงเกินไปสำหรับอุณหภูมิล็อค $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message อุณหภูมิ F $tempF สูงเกินไปสำหรับอุณหภูมิล็อค $highLockTemp
details $tempF
$highLockTemp

อุณหภูมิ F ต่ำเกินไปสำหรับอุณหภูมิล็อค

เทอร์โมได้รับการ ล็อค โดยผู้ใช้สินค้าและพยายามที่จะตั้งอุณหภูมิเป้าหมายฟาเรนไฮต์ต่ำกว่าช่วงอุณหภูมิล็อค

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error อุณหภูมิ F $tempF อยู่ในระดับต่ำเกินไปสำหรับอุณหภูมิล็อค $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message อุณหภูมิ F $tempF อยู่ในระดับต่ำเกินไปสำหรับอุณหภูมิล็อค $lowLockTemp
details $tempF
$lowLockTemp

ค่าอุณหภูมิ F สูงเกินไป

ผลิตภัณฑ์พยายามตั้งค่าอุณหภูมิเป้าหมายที่สูงเกินไปสำหรับอุณหภูมิฟาเรนไฮต์ สำหรับการได้รับอนุญาตช่วงอุณหภูมิในฟาเรนไฮต์ดู target_temperature_f

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่า F อุณหภูมิสูงเกินไป: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message ค่า F อุณหภูมิสูงเกินไป: $tempF
details $tempF

ค่าอุณหภูมิ F ต่ำเกินไป

ผลิตภัณฑ์พยายามตั้งค่าอุณหภูมิเป้าหมายที่ต่ำเกินไปสำหรับอุณหภูมิฟาเรนไฮต์ สำหรับการได้รับอนุญาตช่วงอุณหภูมิในฟาเรนไฮต์ดู target_temperature_f

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่า F อุณหภูมิต่ำเกินไป: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message ค่า F อุณหภูมิต่ำเกินไป: $tempF
details $tempF

อุณหภูมิอยู่ในรูปแบบที่ไม่ถูกต้อง

ผลิตภัณฑ์ที่พยายามที่จะตั้งอุณหภูมิเป้าหมายโดยใช้รูปแบบตัวเลขผิดที่เลือก temperature_scale อุณหภูมิเซลเซียสควรเป็นจำนวนเต็มโดยเพิ่มขึ้นทีละ 0.5 องศา (21.5) และอุณหภูมิฟาเรนไฮต์ควรเป็นจำนวนเต็ม (72)

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error อุณหภูมิ $temp อยู่ในรูปแบบที่ไม่ถูกต้อง
type https://developers.nest.com/reference/error-messages#format-error
message อุณหภูมิ $temp อยู่ในรูปแบบที่ไม่ถูกต้อง
details $temp

ไม่สามารถแก้ไขฟิลด์ในการปรับปรุง

ผลิตภัณฑ์พยายามเขียนลงในฟิลด์แบบอ่านอย่างเดียว

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ฟิลด์ (s) ไม่สามารถแก้ไขได้ในการปรับปรุง: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message ฟิลด์ (s) ไม่สามารถแก้ไขได้ในการปรับปรุง: $fieldNames
details $fieldNames

ฟิลด์ควรใช้รูปแบบ ISO 8601

ข้อมูลไม่ได้อยู่ใน มาตรฐาน ISO 8601 รูปแบบ

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ฟิลด์ (s) ควรใช้รูปแบบ ISO 8601: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message ฟิลด์ (s) ควรใช้รูปแบบ ISO 8601: $fieldNames
details $fieldNames

ตัวควบคุมอุณหภูมิไม่ได้ออนไลน์

ตัวควบคุมอุณหภูมิออฟไลน์อยู่ หลังจากเปิดใช้งาน Wi-Fi ผลิตภัณฑ์ของคุณควรเข้าถึงได้อีกครั้ง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ตัวควบคุมอุณหภูมิไม่ได้ออนไลน์
type https://developers.nest.com/reference/error-messages#not-online
message ตัวควบคุมอุณหภูมิไม่ได้ออนไลน์

การเดินทางนี้ถูกแทนที่ด้วยตนเอง

ผู้ใช้ได้แก้ไขการเดินทางด้วยตนเอง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error การเดินทางนี้ถูกแทนที่ด้วยตนเอง
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message การเดินทางนี้ถูกแทนที่ด้วยตนเอง

ไม่สามารถสร้างที่ ID

wheres วัตถุจะหายไป ไม่มี where_id ค่าที่กำหนดไว้

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่สามารถสร้างที่ id
type https://developers.nest.com/reference/error-messages#wheres-missing
message ไม่สามารถสร้างที่ id

ไม่ได้รับอนุญาต

การให้สิทธิ์ล้มเหลว

เงื่อนไขสองสามข้ออาจสร้างข้อความแสดงข้อผิดพลาดนี้:

  • การเปลี่ยนเส้นทางที่ไม่ถูกต้องซึ่งเกิดขึ้นเมื่อการใช้งาน HTTP ที่กำหนดไม่ส่งต่อส่วนหัวการให้สิทธิ์ไปยัง URI ที่เปลี่ยนเส้นทางโดยอัตโนมัติ สำหรับข้อมูลเพิ่มเติมโปรดดูที่ วิธีการจัดการการเปลี่ยนเส้นทาง

  • สิทธิ์ที่ไม่ถูกต้องเมื่อพยายามเข้าถึงปลายทาง API ตัวอย่างเช่น พยายามอ่านจุดสิ้นสุดของตัวควบคุมอุณหภูมิเมื่อเลือกการอนุญาตของกล้องสำหรับไคลเอนต์เท่านั้น สำหรับข้อมูลเพิ่มเติมโปรดดูที่ วิธีการเลือกสิทธิ์

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 401 ไม่ได้รับอนุญาต
error ไม่ได้รับอนุญาต
type https://developers.nest.com/reference/error-messages#auth-error
message ไม่ได้รับอนุญาต

ไม่รู้จัก

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่รู้จัก
type https://developers.nest.com/reference/error-messages#unknown
message ไม่รู้จัก

ไม่ทราบผู้จำหน่าย/ประเภทอุปกรณ์

ไม่รู้จักผู้จำหน่าย/อุปกรณ์ระหว่างการจับคู่อุปกรณ์

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ไม่ทราบผู้จำหน่าย/ประเภทอุปกรณ์
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message ไม่ทราบผู้จำหน่าย/ประเภทอุปกรณ์

ค่าของ $fieldName เป็นประเภทที่ไม่ถูกต้อง

ส่งข้อมูลผิดประเภท ตัวอย่างเช่น การส่งสตริงเมื่อคาดหวังบูลีน

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ค่าของ $fieldName เป็นประเภทที่ไม่ถูกต้อง
type https://developers.nest.com/reference/error-messages#wrong-data-type
message ค่าของ $fieldName เป็นประเภทที่ไม่ถูกต้อง
details $fieldName

ที่มีชื่ออยู่แล้ว

where_name สินค้าพยายามที่จะชุดที่มีอยู่แล้ว ลองอีกครั้งด้วยชื่อใหม่

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ที่ไหนชื่อ $name อยู่แล้ว
type https://developers.nest.com/reference/error-messages#where-name-exists
message ที่ไหนชื่อ $name อยู่แล้ว
details $name

ในกรณีที่ไม่ได้ระบุชื่อ

where_name หายไปจากการโทร

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error ในกรณีที่ไม่ได้ระบุชื่อ
type https://developers.nest.com/reference/error-messages#where-name-missing
message ในกรณีที่ไม่ได้ระบุชื่อ

โดยที่ชื่อมีความยาวเป็นศูนย์

ที่ name ไม่ได้ถูกกำหนด (มีศูนย์ตัวอักษร)

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โดยที่ชื่อมีความยาวเป็นศูนย์
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message โดยที่ชื่อมีความยาวเป็นศูนย์

โดยที่ชื่อต้องเป็นสตริง

ชนิดข้อมูลที่ไม่ถูกต้องถูกส่งสำหรับ where_name ตัวอย่างเช่น ตัวเลขเมื่อคาดหวังสตริง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error โดยที่ชื่อต้องเป็นสตริง
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message โดยที่ชื่อต้องเป็นสตริง

where_id ไม่มีอยู่

where_id ไม่ถูกต้อง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error where_id ไม่มีอยู่
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id ไม่มีอยู่
details $where_id

where_id ต้องเป็นสตริง

where_id รูปแบบไม่ถูกต้อง ตัวอย่างเช่น มีการส่งตัวเลขแทนสตริง

พารามิเตอร์
สถานะ HTTP รหัสสินค้า: 400 ร้องขอไม่ถูกต้อง
error where_id ต้องเป็นสตริง
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id ต้องเป็นสตริง

รหัสข้อผิดพลาดและข้อความอื่นๆ

รหัสข้อผิดพลาดของอุปกรณ์

สำหรับรหัสข้อผิดพลาดเฉพาะอุปกรณ์และข้อความที่ไม่เกี่ยวข้องกับ Nest API โปรดดูสิ่งต่อไปนี้

รหัสข้อผิดพลาด REST

เมื่อคุณทำการเรียก REST API รหัสสถานะ HTTP ทั่วไปจะถูกส่งคืน

ข้อความจำกัดอัตรา REST

เมื่อใช้ REST และคุณส่งสายมากเกินไปในระยะเวลาสั้น ๆ คุณอาจได้รับรหัสสถานะการตอบสนอง HTTP 429 มากเกินไปจอง

สำหรับข้อมูลเพิ่มเติมโปรดดูที่ ขีด จำกัด อัตราข้อมูล