Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

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

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

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

การปิดเครื่องฉุกเฉิน มีผลบังคับใช้ ไม่ยอมรับการเรียก 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 ของ Thermostat ไม่รองรับโหมดที่ผลิตภัณฑ์ของคุณร้องขอ: 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 mode ที่เข้ากันไม่ได้
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message ไม่สามารถตั้งค่าเปิด / ปิด fan_timer_active เนื่องจากโหมด $mode 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 ไม่สามารถตั้งอุณหภูมิเป้าหมายให้ใกล้กว่า $scale $min degrees $scale
details $min
$scale

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

ขณะนี้ตัวควบคุมอุณหภูมิหรือโครงสร้างอยู่ในโหมดที่ไม่รองรับคำขอ 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 ได้

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

พารามิเตอร์
รหัสสถานะ 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 โปรดดูคู่มือ Away & ETA

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

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

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

พารามิเตอร์
รหัสสถานะ HTTP: 400 คำขอไม่ถูกต้อง
error กทพ. อยู่ไกลเกินไปในอนาคต
type https://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
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message ไม่ได้ตั้งค่า fan_timer_active

ต้องห้าม

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

พารามิเตอร์
รหัสสถานะ HTTP: 403 Forbidden
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
details $id

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

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

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

เส้นทางแฟรกเมนต์ไม่ถูกต้อง

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

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

รหัสการเตือนภัยควัน + ร่วมไม่ถูกต้อง

smoke_co_alarm_id ไม่ถูกต้อง

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

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

structure_id ไม่ถูกต้อง

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

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

thermostat_id ไม่ถูกต้อง

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

ค่าไม่ถูกต้องสำหรับทีมเยือน

คุณพยายามตั้งค่าที่ไม่ถูกต้องสำหรับไม่ 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 รูปแบบ where_id

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

ไม่มีพัดลม 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 ไม่มีสิทธิ์เขียนสำหรับฟิลด์: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message ไม่มีสิทธิ์เขียนสำหรับฟิลด์: $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 การ โทร 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 ไม่สามารถแก้ไขฟิลด์ในการอัพเดต: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message ไม่สามารถแก้ไขฟิลด์ในการอัพเดต: $fieldNames
details $fieldNames

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

ฟิลด์ไม่อยู่ในรูปแบบ ISO 8601

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

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

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

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

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

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

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

พารามิเตอร์
รหัสสถานะ 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 คำขอที่มากเกินไป

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