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

เงื่อนไขข้อผิดพลาดเป็นส่วนหนึ่งของวงจรการพัฒนาซึ่งอาจมีตั้งแต่ข้อผิดพลาดง่ายๆ เช่น พารามิเตอร์ที่ไม่ถูกต้องหรือขาดหายไป ไปจนถึงสถานการณ์ที่ซับซ้อนขึ้น เช่น สถานะที่ไม่คาดคิดหรือแม้กระทั่งการตั้งค่าเกี่ยวกับอุปกรณ์ ซึ่งต้องแก้ไขนอก 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ถูกบล็อก
typehttps://developers.nest.com/reference/error-messages#blocked
messageถูกบล็อก

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

การปิดฉุกเฉิน จะมีผล ระบบจะไม่ยอมรับการเรียก API จนกว่าจะคืนค่าตามปกติ

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

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

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

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

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

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorเปลี่ยนโหมด HVAC ระหว่างกิจกรรมประหยัดพลังงานไม่ได้
typehttps://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
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageเปลี่ยนโหมด HVAC เป็น $mode ไม่ได้ HVAC ต้องไม่$action
details$mode
$action

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

ผู้ใช้ต้องปลดล็อกตัวควบคุมอุณหภูมิก่อน ผลิตภัณฑ์จึงจะเขียนข้อมูลได้

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

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

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorตั้งค่าอุณหภูมิ C และ F พร้อมกันไม่ได้
typehttps://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
typehttps://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 สําหรับค่าที่อนุญาต
typehttps://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
typehttps://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 ไม่ได้
typehttps://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
typehttps://developers.nest.com/reference/error-messages#mode-error
messageไม่สามารถตั้งค่า $fieldName ขณะที่โหมดคือ $mode
details$fieldName
$mode

ต้องอัปเดตเฟิร์มแวร์ของอุปกรณ์ก่อนจึงจะเปลี่ยนโหมด HVAC ได้

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

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

เกิดข้อผิดพลาดขณะตรวจสอบความถูกต้องของช่อง WWN

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

เวลาถึงโดยประมาณผ่านมาแล้ว

เวลาถึงโดยประมาณที่ระบุไว้เป็นวันที่ผ่านมาแล้ว (ก่อน NOW) ดูข้อมูลเพิ่มเติมเกี่ยวกับการโทรหาเวลาถึงโดยประมาณได้ในคําแนะนําเกี่ยวกับ "ไม่อยู่บ้าน" และ "เวลาถึงโดยประมาณ"

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorเวลาถึงโดยประมาณคือ $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageเวลาถึงโดยประมาณคือ $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

เวลาถึงโดยประมาณนานเกินไป

เวลาถึงโดยประมาณที่ระบุต้องไม่เกิน 8 ชั่วโมงในอนาคต ดูข้อมูลเพิ่มเติมเกี่ยวกับการโทรออกเวลาถึงโดยประมาณได้ที่คําแนะนําเกี่ยวกับไม่อยู่บ้านและเวลาถึงโดยประมาณ

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

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

ไม่ได้กําหนด fan_timer_active

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

ต้องห้าม

ข้อมูลเข้าสู่ระบบที่ใช้เข้าถึงบริการ Nest ไม่ถูกต้อง

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

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

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

รหัสกล้องไม่ถูกต้อง

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

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

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

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

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

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

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

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

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

ระบบ HVAC ของตัวควบคุมอุณหภูมิไม่รองรับโหมดที่ผลิตภัณฑ์ขอ ได้แก่ heat, cool หรือ heat-cool

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

รหัสสัญญาณเตือนควันและco ไม่ถูกต้อง

smoke_co_alarm_id ไม่ถูกต้อง

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorรหัสสัญญาณเตือนควัน+co ไม่ถูกต้อง $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageรหัสสัญญาณเตือนควันและco ไม่ถูกต้อง: $id
details$id

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

structure_id ไม่ถูกต้อง

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

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

thermostat_id ไม่ถูกต้อง

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorรหัสตัวควบคุมอุณหภูมิ $id ไม่ถูกต้อง
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageรหัสตัวควบคุมอุณหภูมิไม่ถูกต้อง: $id
details$id

ค่า "ไม่อยู่บ้าน" ไม่ถูกต้อง

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorค่า "ไม่อยู่บ้าน" ไม่ถูกต้อง
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageค่าไม่ถูกต้อง: $value เฉพาะค่า 'home' & 'away' เป็นค่าที่อนุญาต
details$value

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

ผลิตภัณฑ์พยายามตั้งค่าช่อง is-streaming เป็นบูลีน

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

ป้ายกํากับต้องมีอักขระไม่เกิน 256 ตัว

ผลิตภัณฑ์พยายามสร้างป้ายกํากับตัวควบคุมอุณหภูมิที่มีอักขระมากกว่า 256 ตัว

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorป้ายกํากับต้องมีอักขระไม่เกิน $max_label_length ตัว
typehttps://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 เกินขีดจํากัด
typehttps://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 เกินขีดจํากัด
typehttps://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
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageไม่มีฟิลด์: $fieldName
details$fieldName

ไม่มีรหัสสถานที่

ไม่มีรูปแบบ where_id

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

ไม่มีพัดลม HVAC

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

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

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

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

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

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

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

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

ไม่มีเวลาถึงโดยประมาณเพื่อยกเลิก

การเดินทางนี้ไม่ถูกต้อง จึงยกเลิกไม่ได้

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorไม่มีเวลาถึงโดยประมาณเพื่อยกเลิก
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageไม่มีเวลาถึงโดยประมาณเพื่อยกเลิก

ไม่มีสิทธิ์เขียนในช่อง

ไคลเอ็นต์ไม่มีสิทธิ์เขียนข้อมูลนี้ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของสิทธิ์

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorไม่มีสิทธิ์เขียนในช่อง: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageไม่มีสิทธิ์เขียนในช่อง: $fields
details$fields

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

ประเภทคําขอไม่ถูกต้อง เช่น การโทร POST จะเกิดขึ้นเมื่อต้องใช้ PUT

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

ไม่พบ

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

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

ไม่ได้อยู่ในโหมดไม่อยู่บ้าน

โครงสร้างจะไม่อยู่ในโหมด "ไม่อยู่บ้าน" เมื่อมีการเรียกเวลาถึงโดยประมาณ ระบบจะยอมรับการเรียก ETA เมื่อตั้งค่าโครงสร้างเป็น "ไม่อยู่บ้าน" เท่านั้น

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

เขียนไม่ได้

ช่องที่คุณพยายามเขียนเป็นแบบอ่านอย่างเดียว

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

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

ช่อง wheres จะรวมอยู่ในช่องเพิ่มเติม

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

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

ประเภทคําขอไม่ถูกต้อง เช่น การโทร POST จะเกิดขึ้นเมื่อต้องใช้ PUT

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

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

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

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

ไม่พร้อมให้บริการ

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

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

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

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

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

structure_id ไม่ตรงกับบัญชีผู้ใช้ที่มีระเบียน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorอุณหภูมิ F $tempF สูงเกินไปสําหรับอุณหภูมิล็อก $highLockTemp
typehttps://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
typehttps://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
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageค่าอุณหภูมิ F สูงเกินไป: $tempF
details$tempF

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

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorค่าอุณหภูมิ F ต่ําเกินไป: $tempF
typehttps://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 อยู่ในรูปแบบที่ไม่ถูกต้อง
typehttps://developers.nest.com/reference/error-messages#format-error
messageอุณหภูมิ $temp อยู่ในรูปแบบที่ไม่ถูกต้อง
details$temp

แก้ไขช่องเมื่ออัปเดตไม่ได้

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คําขอไม่ถูกต้อง
errorแก้ไขช่องในการอัปเดตไม่ได้: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageแก้ไขช่องในการอัปเดตไม่ได้: $fieldNames
details$fieldNames

ช่องนี้ควรใช้รูปแบบ ISO 8601

ช่องนี้ไม่ได้อยู่ในรูปแบบ ISO 8601

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

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

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

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

ลบล้างการเดินทางนี้ด้วยตนเองแล้ว

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

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

สร้างรหัสสถานที่ไม่ได้

ไม่มีออบเจ็กต์ wheres ไม่ได้กําหนดค่า where_id

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

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

การให้สิทธิ์ไม่สําเร็จ

มีเงื่อนไข 2-3 ข้อที่อาจทําให้เกิดข้อความแสดงข้อผิดพลาดนี้

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

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

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

ไม่ทราบ

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

ประเภทผู้ให้บริการ/อุปกรณ์ที่ไม่รู้จัก

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

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

ค่าของ $fieldName ไม่ถูกต้อง

มีการส่งประเภทข้อมูลที่ไม่ถูกต้อง เช่น การส่งสตริงเมื่อคาดว่าจะใช้บูลีน

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

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

มี where_name ที่ผลิตภัณฑ์พยายามตั้งค่าอยู่แล้ว ลองอีกครั้งโดยใช้ชื่อใหม่

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

ไม่ได้ระบุชื่อ

ไม่มี where_name ในการโทร

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

ที่ชื่อมีความยาวเป็น 0

ตรงตําแหน่งที่ไม่ได้กําหนด name (ไม่มีอักขระ)

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

ชื่อต้องเป็นสตริง

มีการส่งประเภทข้อมูลที่ไม่ถูกต้องสําหรับ where_name เช่น ตัวเลขที่คาดไว้

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

ไม่มีอยู่

where_id ไม่ถูกต้อง

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

รหัสตําแหน่งต้องเป็นสตริง

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

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

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

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

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

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ขีดจํากัดอัตราข้อมูล