Notice: We're retiring Works with Nest. See the home page for more information.
Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Thông báo lỗi

Các điều kiện lỗi là một phần của chu trình phát triển và có thể bao gồm từ các lỗi đơn giản, như tham số không hợp lệ hoặc thiếu, đến các tình huống phức tạp hơn, chẳng hạn như trạng thái không mong muốn hoặc thậm chí các cài đặt liên quan đến thiết bị, phải được giải quyết bên ngoài API.

Khi xảy ra lỗi trong khi gọi API, phản hồi ở định dạng này sẽ được gửi: 

{
  "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"
  }
}

Tất cả các thông báo lỗi chứa các trường error , type , message và instance . Các đối tượng details là tùy chọn.

Cánh đồng Sự miêu tả
error Định dạng thông báo lỗi ngắn.
type Cung cấp một URL để thông tin chi tiết về tình trạng lỗi (trang này).
message Định dạng thông báo lỗi dài có thể sử dụng các biến để cung cấp thêm chi tiết. Khi một biến được bao gồm trong thông báo, nó sẽ xuất hiện trong đối tượng details .
instance Một chuỗi văn bản chứa một mã định danh lỗi duy nhất cho mỗi cuộc gọi riêng lẻ. Chúng tôi có thể yêu cầu bạn cho số hiệu nếu bạn báo cáo sự cố với dịch vụ.
details Không bắt buộc. Chứa các biến được chèn vào message . Tin nhắn có thể chứa nhiều biến.

Để biết thông tin về các lỗi không liên quan đến API Nest, hãy xem các thông báo và mã lỗi khác .

Bị chặn

Giới hạn tỷ lệ đã được vượt quá.

Thông số
Mã trạng thái HTTP: 429 Quá nhiều yêu cầu
error Bị chặn
type https://developers.nest.com/reference/error-messages#blocked
message Bị chặn

Không thể kích hoạt quạt trong khi tắt khói / đồng an toàn

Tắt khẩn cấp có hiệu lực. Các lệnh gọi API không được chấp nhận cho đến khi hoạt động bình thường được khôi phục.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể kích hoạt quạt trong khi tắt khói / đồng an toàn
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message Không thể kích hoạt quạt trong khi tắt khói / đồng an toàn

Không thể thay đổi trạng thái Away khi bật nhiệt khẩn cấp

Sản phẩm đã cố gắng thay đổi trạng thái Away trong khi Heat Heat được bật.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể thay đổi trạng thái Away khi bật nhiệt khẩn cấp
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message Không thể thay đổi trạng thái Away khi bật nhiệt khẩn cấp

Không thể thay đổi chế độ HVAC trong các sự kiện tiết kiệm năng lượng

Một sự kiện tiết kiệm năng lượng được xác định bởi đối tác năng lượng Nest có hiệu lực. Các lệnh gọi API bị từ chối cho đến khi sự kiện tiết kiệm năng lượng kết thúc.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể thay đổi chế độ HVAC trong các sự kiện tiết kiệm năng lượng
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message Không thể thay đổi chế độ HVAC trong các sự kiện tiết kiệm năng lượng

Không thể thay đổi chế độ HVAC

Chế độ không tương thích với yêu cầu.

Ví dụ: bạn có thể nhận được thông báo này nếu:

  • Hệ thống HVAC của Bộ điều nhiệt không hỗ trợ chế độ theo yêu cầu của sản phẩm của bạn: heat , cool , heat-cool , hoặc eco
  • Chế độ HVAC được đặt thành eco và sản phẩm cố gắng đặt target_temperature
Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể thay đổi chế độ HVAC thành chế độ $mode ; HVAC không thể $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message Không thể thay đổi chế độ HVAC thành chế độ $mode ; HVAC không thể $action
details $mode
$action

Không thể thay đổi chế độ HVAC trong khi bật khóa nhiệt

Người dùng phải mở khóa bộ điều nhiệt trước khi sản phẩm có thể ghi dữ liệu.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể thay đổi chế độ HVAC trong khi bật khóa nhiệt
type https://developers.nest.com/reference/error-messages#lock-enabled
message Không thể thay đổi chế độ HVAC trong khi bật khóa nhiệt

Không thể đặt nhiệt độ C và F đồng thời

Sản phẩm đã cố gắng đặt cả nhiệt độ mục tiêu Celsius và Fahrenheit cùng một lúc. Một sản phẩm chỉ nên đặt nhiệt độ mục tiêu được chỉ định bởi temperature_scale (C / F).

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt nhiệt độ C và F đồng thời
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message Không thể đặt nhiệt độ C và F đồng thời

Không thể bật / tắt fan_timer_active do chế độ không tương thích

Quạt hệ thống HVAC đã được kích hoạt (do người dùng thủ công hoặc theo lịch hoặc do chu trình làm nóng / làm mát HVAC).

Nếu bạn không nhận được kết quả như mong đợi, rất có thể là do thiết bị có hành vi tích hợp mà chúng tôi không thể ghi đè qua API.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt bật / tắt fan_timer_active do chế độ không tương thích $mode
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message Không thể đặt bật / tắt fan_timer_active do chế độ không tương thích $mode
details $mode

Không thể đặt fan_timer_duration thành giá trị đã chọn

Sản phẩm đã cố gắng đặt fan_timer_duration thành giá trị không hợp lệ. Xem fan_timer_duration để biết danh sách các giá trị hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt fan_timer_duration thành giá trị đã chọn. Xem tài liệu tham khảo API cho các giá trị được phép.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message Không thể đặt fan_timer_duration thành giá trị đã chọn. Xem tài liệu tham khảo API cho các giá trị được phép.

Không thể đặt mục tiêu nhiệt độ thấp cao hơn nhiệt độ cao mục tiêu

Bộ điều chỉnh nhiệt ở chế độ heat-cool bằng heat-cool và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu thấp / cao nằm ngoài phạm vi. Ví dụ: sản phẩm đã cố gắng đặt target_temperature_low_c thành 25 ° C khi target_temperature_high_c là 24 ° C.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt mục tiêu nhiệt độ thấp $lowTemp cao hơn mục tiêu nhiệt độ cao $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message Không thể đặt mục tiêu nhiệt độ thấp $lowTemp cao hơn mục tiêu nhiệt độ cao $highTemp
details $lowTemp
$highTemp

Không thể đặt nhiệt độ mục tiêu gần hơn N độ C / F

Sản phẩm đã cố gắng đặt giá trị nhiệt độ mục tiêu quá gần với nhiệt độ cao / thấp của mục tiêu (ví dụ: target_temperature_high_f ).

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt nhiệt độ mục tiêu gần hơn N độ C / F
type https://developers.nest.com/reference/error-messages#range-error
message Không thể đặt nhiệt độ mục tiêu gần hơn $min độ $scale
details $min
$scale

Không thể đặt target_tem Nhiệt độ trong khi chế độ là chế độ $

Bộ điều chỉnh nhiệt hoặc cấu trúc hiện đang ở chế độ không hỗ trợ các yêu cầu API.

Ví dụ: bạn không thể đặt target_temperature_f hoặc target_temperature_c khi hệ thống HVAC off hoặc ở chế độ heat-cool bằng heat-cool . Không thể thay đổi giá trị cho đến khi bộ điều chỉnh nhiệt / cấu trúc chuyển về chế độ không bị hạn chế.

Trong thông báo này, $fieldName có thể là bất kỳ giá trị nhiệt độ đích nào và $mode có thể là bất kỳ: eco , emer_heat_enable , heat-cool heat , heat , cool , off , hvac_safety_shutoff_active .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể đặt target_tem Nhiệt độ trong khi chế độ là $mode
type https://developers.nest.com/reference/error-messages#mode-error
message Không thể đặt $fieldName trong khi chế độ là $mode
details $fieldName
$mode

Yêu cầu cập nhật firmware thiết bị trước khi bạn có thể thay đổi chế độ HVAC

Thiết bị phải được cập nhật lên phiên bản phần sụn hiện tại để đặt Nhiệt độ sinh thái.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Yêu cầu cập nhật firmware thiết bị trước khi bạn có thể thay đổi chế độ HVAC. Cập nhật là tự động, thường trong vòng một tuần phát hành.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message Yêu cầu cập nhật firmware thiết bị trước khi bạn có thể thay đổi chế độ HVAC. Cập nhật là tự động, thường trong vòng một tuần phát hành.

Lỗi trong khi xác thực các trường WWN

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Lỗi trong khi xác thực các trường WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message Lỗi trong khi xác thực các trường WWN: $error
details $error

ETA là trong quá khứ

Thời gian ETA được chỉ định là trong quá khứ (trước NGAY BÂY GIỜ). Để biết thêm thông tin về cách thực hiện các cuộc gọi ETA, hãy xem Hướng dẫn Away & ETA .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error ETA là trong quá khứ: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA là trong quá khứ: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA là quá xa trong tương lai

Thời gian ETA được chỉ định không thể quá 8 giờ trong tương lai. Để biết thêm thông tin về cách thực hiện các cuộc gọi ETA, hãy xem Hướng dẫn Away & ETA .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error ETA là quá xa trong tương lai
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA là quá xa trong tương lai

fan_timer_active chưa được đặt

fan_timer_active không được xác định.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error fan_timer_active chưa được đặt
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active chưa được đặt

Cấm

Thông tin đăng nhập đang được sử dụng để truy cập dịch vụ Nest không hợp lệ.

Thông số
Mã trạng thái HTTP: 403 Bị cấm
error Cấm
type https://developers.nest.com/reference/error-messages#forbidden
message Cấm

Lỗi bên trong

Thông số
Mã trạng thái HTTP: 500 Lỗi máy chủ nội bộ
error Lỗi bên trong
type https://developers.nest.com/reference/error-messages#internal-error
message Lỗi bên trong

ID camera không hợp lệ

camera-id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Id camera không hợp lệ $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message Id camera không hợp lệ: $id
details $id

Nội dung không hợp lệ được gửi

Cuộc gọi chứa nội dung không hợp lệ. Ví dụ: sử dụng "có" thay vì "true" cho biến boolean.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nội dung không hợp lệ được gửi
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message Nội dung không hợp lệ được gửi

Đường dẫn đoạn không hợp lệ

Một phần của đường dẫn yêu cầu không hợp lệ. Ví dụ, một đối tượng hoặc tên trường có thể bị sai chính tả.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Đường dẫn đoạn không hợp lệ: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message Đường dẫn đoạn không hợp lệ: $requestPath
details $requestPath

Chế độ HVAC không hợp lệ

Hệ thống HVAC của bộ điều nhiệt không hỗ trợ chế độ theo yêu cầu của sản phẩm: heat , cool hoặc heat-cool .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Chế độ HVAC không hợp lệ: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message Chế độ HVAC không hợp lệ: $mode
details $mode

Khói không hợp lệ + ID báo động đồng

smoke_co_alarm_id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Khói không hợp lệ + đồng báo động id $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message Khói không hợp lệ + đồng báo động id: $id
details $id

ID cấu trúc không hợp lệ

structure_id trúc_id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Cấu trúc id không hợp lệ $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message Id cấu trúc không hợp lệ: $id
details $id

ID bộ điều nhiệt không hợp lệ

Bộ thermostat_id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Id nhiệt không hợp lệ $id
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message Id bộ điều chỉnh nhiệt không hợp lệ: $id
details $id

Giá trị không hợp lệ cho Away

Bạn đã cố gắng đặt một giá trị không hợp lệ cho away .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Giá trị không hợp lệ cho Away
type https://developers.nest.com/reference/error-messages#invalid-away-value
message Giá trị không hợp lệ: $value . Chỉ 'nhà' và 'đi' là giá trị được phép.
details $value

is_streaming không phải là boolean

Sản phẩm đã cố gắng đặt trường is-streaming thành không phải boolean.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error is_streaming không phải là boolean
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming không phải là boolean

Nhãn phải nhỏ hơn 256 ký tự

Sản phẩm đã cố gắng tạo nhãn Nhiệt với hơn 256 ký tự.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhãn phải nhỏ hơn $max_label_length ký tự
type https://developers.nest.com/reference/error-messages#max-label-length
message Nhãn phải nhỏ hơn $max_label_length ký tự
details $max_label_length

Tối đa tùy chỉnh nơi vượt quá số lượng

Sản phẩm này đã cố gắng để tạo ra một tùy chỉnh wheres đối tượng vượt quá mức tối đa. Số lượng tối đa tùy chỉnh wheres đối tượng cho phép là 32.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tùy chỉnh tối đa khi vượt quá số lượng $max_where_count
type https://developers.nest.com/reference/error-messages#max-where-count
message Tùy chỉnh tối đa khi vượt quá số lượng $max_where_count
details $max_where_count

Tối đa tùy chỉnh nơi vượt quá độ dài tên

name quá dài. Chúng tôi đề nghị ít hơn 30 ký tự.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tùy chỉnh tối đa trong đó độ dài tên của $max_custom_where_name_length vượt quá
type https://developers.nest.com/reference/error-messages#max-where-name-length
message Tùy chỉnh tối đa trong đó độ dài tên của $max_custom_where_name_length vượt quá
details $max_custom_where_name_length

Lĩnh vực thiếu

Cuộc gọi bị thiếu một tham số bắt buộc.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Trường bị thiếu: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Trường bị thiếu: $fieldName
details $fieldName

Thiếu ID ở đâu

Định dạng where_id bị thiếu.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Thiếu Id
type https://developers.nest.com/reference/error-messages#where-id-missing
message Thiếu Id

Không có quạt HVAC

Hệ thống HVAC dường như không có quạt độc lập.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không có người hâm mộ hvac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message Không có người hâm mộ hvac

Không có bộ điều nhiệt trực tuyến

Bộ điều nhiệt hiện đang offline. Sau khi wi-fi được bật, sản phẩm của bạn sẽ lấy lại quyền truy cập.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không có bộ điều nhiệt trực tuyến
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message Không có bộ điều nhiệt trực tuyến

Không có thiết bị ghép nối

Các thiết bị Nest của người dùng không được ghép nối với Tài khoản Nest của người dùng .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không có thiết bị ghép nối
type https://developers.nest.com/reference/error-messages#no-paired-devices
message Không có thiết bị ghép nối

Không có ETA hợp lệ để hủy

Chuyến đi không hợp lệ và không thể hủy bỏ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không có ETA hợp lệ để hủy
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message Không có ETA hợp lệ để hủy

Không có quyền ghi (các) trường cho (các) trường

Khách hàng không có quyền ghi cho dữ liệu này. Để biết thêm thông tin, xem Tổng quan về Quyền .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không có quyền ghi (các) trường cho (các) trường: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message Không có quyền ghi (các) trường cho (các) trường: $fields
details $fields

Không phải là loại yêu cầu hợp lệ

Loại yêu cầu không hợp lệ. Ví dụ, một cuộc gọi POST được thực hiện khi cần PUT.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không phải là loại yêu cầu hợp lệ: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message Không phải là loại yêu cầu hợp lệ: $requestType
details $requestType

Không tìm thấy

Cuộc gọi đã cố đọc một đường dẫn không tồn tại.

Thông số
Mã trạng thái HTTP: 404 Không tìm thấy
error Không tìm thấy
type https://developers.nest.com/reference/error-messages#not-found
message Không tìm thấy

Không ở chế độ Đi vắng

Cấu trúc không ở chế độ Away khi thực hiện cuộc gọi ETA. Các cuộc gọi ETA chỉ được chấp nhận khi cấu trúc được đặt thành Away.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không ở chế độ Đi vắng
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Không ở chế độ Đi vắng

Không thể ghi

Trường bạn đang cố ghi là chỉ đọc.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể ghi
type https://developers.nest.com/reference/error-messages#not-writable
message Không thể ghi

Chỉ nơi nào cần cung cấp tên

Trường bổ sung được đưa vào wheres gọi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Chỉ nơi nào cần cung cấp tên
type https://developers.nest.com/reference/error-messages#extra-fields
message Chỉ nơi nào cần cung cấp tên

POST không phải là loại yêu cầu hợp lệ

Loại yêu cầu không hợp lệ. Ví dụ, một cuộc gọi POST được thực hiện khi cần PUT.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error POST không phải là loại yêu cầu hợp lệ
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST không phải là loại yêu cầu hợp lệ

Vi phạm lược đồ

Xảy ra lỗi khi ghép thiết bị.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Vi phạm lược đồ
type https://developers.nest.com/reference/error-messages#schema-violation-error
message Vi phạm lược đồ

Dịch vụ Không sẵn có

Thông số
Mã trạng thái HTTP: 503 Dịch vụ không khả dụng
error dịch vụ Không sẵn có
type https://developers.nest.com/reference/error-messages#service-unavailable
message dịch vụ Không sẵn có

Cấu trúc đã có số lượng tối đa các thiết bị được ghép nối được phép

Cấu trúc đã có số lượng tối đa của các thiết bị được phép .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Cấu trúc đã có số lượng tối đa các thiết bị được ghép nối được phép
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message Cấu trúc đã có số lượng tối đa các thiết bị được ghép nối được phép

Cấu trúc không thuộc sở hữu của người dùng

structure_id trúc_id không khớp với tài khoản người dùng của bản ghi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Cấu trúc không thuộc sở hữu của người dùng.
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message Cấu trúc không thuộc sở hữu của người dùng.

Nhiệt độ C quá cao so với nhiệt độ khóa

Bộ điều chỉnh nhiệt đã bị khóa bởi người dùng và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu Celsius cao hơn phạm vi nhiệt độ khóa.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ C $tempC quá cao so với nhiệt độ khóa $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message Nhiệt độ C $tempC quá cao so với nhiệt độ khóa $highLockTemp
details $tempC
$highLockTemp

Nhiệt độ C quá thấp so với nhiệt độ khóa

Bộ điều chỉnh nhiệt đã bị khóa bởi người dùng và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu Celsius thấp hơn phạm vi nhiệt độ khóa.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ C $tempC quá thấp so với nhiệt độ khóa $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message Nhiệt độ C $tempC quá thấp so với nhiệt độ khóa $lowLockTemp
details $tempC
$lowLockTemp

Giá trị nhiệt độ C quá cao

Sản phẩm đã cố gắng đặt giá trị nhiệt độ mục tiêu quá cao so với nhiệt độ Celsius. Đối với phạm vi nhiệt độ được phép trong Celsius, hãy xem target_temperature_c .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ C giá trị quá cao: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message Nhiệt độ C giá trị quá cao: $tempC
details $tempC

Nhiệt độ C giá trị quá thấp

Sản phẩm đã cố gắng đặt giá trị nhiệt độ mục tiêu quá thấp so với nhiệt độ Celsius. Đối với phạm vi nhiệt độ được phép trong Celsius, hãy xem target_temperature_c .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ C giá trị quá thấp: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message Nhiệt độ C giá trị quá thấp: $tempC
details $tempC

Nhiệt độ F quá cao so với nhiệt độ khóa

Bộ điều chỉnh nhiệt đã bị khóa bởi người dùng và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu Fahrenheit cao hơn phạm vi nhiệt độ khóa.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ F $tempF quá cao so với nhiệt độ khóa $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message Nhiệt độ F $tempF quá cao so với nhiệt độ khóa $highLockTemp
details $tempF
$highLockTemp

Nhiệt độ F quá thấp so với nhiệt độ khóa

Bộ điều chỉnh nhiệt đã bị khóa bởi người dùng và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu Fahrenheit thấp hơn phạm vi nhiệt độ khóa.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ F $tempF quá thấp so với nhiệt độ khóa $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message Nhiệt độ F $tempF quá thấp so với nhiệt độ khóa $lowLockTemp
details $tempF
$lowLockTemp

Nhiệt độ F giá trị quá cao

Sản phẩm đã cố gắng đặt giá trị nhiệt độ mục tiêu quá cao so với nhiệt độ Fahrenheit. Để biết phạm vi nhiệt độ cho phép trong Fahrenheit, hãy xem target_temperature_f .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ F giá trị quá cao: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message Nhiệt độ F giá trị quá cao: $tempF
details $tempF

Nhiệt độ F giá trị quá thấp

Sản phẩm đã cố gắng đặt giá trị nhiệt độ mục tiêu quá thấp so với nhiệt độ Fahrenheit. Để biết phạm vi nhiệt độ cho phép trong Fahrenheit, hãy xem target_temperature_f .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ F giá trị quá thấp: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message Nhiệt độ F giá trị quá thấp: $tempF
details $tempF

Nhiệt độ sai định dạng

Sản phẩm đã cố gắng đặt nhiệt độ mục tiêu bằng cách sử dụng định dạng số sai cho temperature_scale đã chọn. Nhiệt độ Celsius phải là số nguyên theo mức tăng 0,5 độ (21,5) và nhiệt độ Fahrenheit phải là toàn bộ số nguyên (72).

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhiệt độ $temp không đúng định dạng
type https://developers.nest.com/reference/error-messages#format-error
message Nhiệt độ $temp không đúng định dạng
details $temp

Trường không thể được sửa đổi khi cập nhật

Sản phẩm đã cố ghi vào trường chỉ đọc.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể sửa đổi (các) trường trên bản cập nhật: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message Không thể sửa đổi (các) trường trên bản cập nhật: $fieldNames
details $fieldNames

Các trường nên sử dụng định dạng ISO 8601

Trường này không ở định dạng ISO 8601 .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error (Các) trường nên sử dụng định dạng ISO 8601: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message (Các) trường nên sử dụng định dạng ISO 8601: $fieldNames
details $fieldNames

Bình giữ nhiệt không trực tuyến

Bộ điều nhiệt hiện đang offline. Sau khi wi-fi được bật, sản phẩm của bạn sẽ lấy lại quyền truy cập.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Bình giữ nhiệt không trực tuyến
type https://developers.nest.com/reference/error-messages#not-online
message Bình giữ nhiệt không trực tuyến

Chuyến đi này đã được ghi đè bằng tay

Người dùng đã tự ghi đè chuyến đi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Chuyến đi này đã được ghi đè bằng tay
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message Chuyến đi này đã được ghi đè bằng tay

Không thể tạo ID ở đâu

Các wheres đối tượng là mất tích. Không có giá trị where_id được xác định.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Không thể tạo id ở đâu
type https://developers.nest.com/reference/error-messages#wheres-missing
message Không thể tạo id ở đâu

Không được phép

Ủy quyền đã thất bại.

Một vài điều kiện có thể tạo ra thông báo lỗi này:

  • chuyển hướng không chính xác xảy ra khi triển khai HTTP đã cho không tự động chuyển tiếp tiêu đề Ủy quyền đến URI được chuyển hướng. Để biết thêm thông tin, hãy xem Cách xử lý chuyển hướng .

  • quyền không chính xác khi cố gắng truy cập điểm cuối API. Ví dụ: cố gắng đọc điểm cuối của Bộ điều chỉnh nhiệt khi chỉ có quyền Máy ảnh được chọn cho máy khách. Để biết thêm thông tin, hãy xem Cách chọn quyền .

Thông số
Mã trạng thái HTTP: 401 trái phép
error Không được phép
type https://developers.nest.com/reference/error-messages#auth-error
message Không được phép

không xác định

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error không xác định
type https://developers.nest.com/reference/error-messages#unknown
message không xác định

Nhà cung cấp / loại thiết bị không xác định

Nhà cung cấp / thiết bị không được công nhận trong quá trình ghép nối thiết bị.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Nhà cung cấp / loại thiết bị không xác định
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message Nhà cung cấp / loại thiết bị không xác định

Giá trị của $ fieldName là loại sai

Loại dữ liệu sai đã được gửi. Ví dụ, gửi một chuỗi khi boolean được mong đợi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Giá trị của $fieldName là loại sai
type https://developers.nest.com/reference/error-messages#wrong-data-type
message Giá trị của $fieldName là loại sai
details $fieldName

Tên đã tồn tại ở đâu

where_name sản phẩm đã cố gắng đặt đã tồn tại. Hãy thử lại với một tên mới.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tên $name đã tồn tại
type https://developers.nest.com/reference/error-messages#where-name-exists
message Tên $name đã tồn tại
details $name

Tên không được cung cấp

where_name bị thiếu trong cuộc gọi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tên không được cung cấp
type https://developers.nest.com/reference/error-messages#where-name-missing
message Tên không được cung cấp

Tên có độ dài bằng không

name không được xác định (có ký tự không).

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tên có độ dài bằng không
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message Tên có độ dài bằng không

Tên phải là một chuỗi

Kiểu dữ liệu sai đã được gửi cho where_name . Ví dụ, một số khi một chuỗi được mong đợi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error Tên phải là một chuỗi
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Tên phải là một chuỗi

where_id không tồn tại

where_id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error where_id không tồn tại
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id không tồn tại
details $where_id

trong đó phải là một chuỗi

Định dạng where_id không hợp lệ. Ví dụ, một số đã được gửi thay vì một chuỗi.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu xấu
error trong đó phải là một chuỗi
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message trong đó phải là một chuỗi

Mã lỗi và thông báo khác

Mã lỗi thiết bị

Để biết các mã lỗi và thông báo cụ thể của thiết bị không liên quan đến API Nest, hãy xem phần sau:

Mã lỗi REST

Khi bạn thực hiện cuộc gọi API REST, các mã trạng thái HTTP phổ biến được trả về.

Tin nhắn giới hạn tốc độ REST

Khi sử dụng REST và bạn gửi quá nhiều cuộc gọi trong một khoảng thời gian ngắn, bạn có thể nhận được mã trạng thái phản hồi HTTP là 429 Quá nhiều yêu cầu.

Để biết thêm thông tin, xem Giới hạn tốc độ dữ liệu .