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 kỳ phát triển và có thể bao gồm từ các lỗi đơn giản, như thông số không hợp lệ hoặc bị 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 cuộc 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 đều chứa các trường error , type , messageinstance . Đố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 URL đến 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 chi tiết bổ sung. 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 Chuỗi văn bản chứa mã nhận dạng lỗi duy nhất cho từng cuộc gọi riêng lẻ. Chúng tôi có thể hỏi bạn số phiên bản 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 Thông báo và mã lỗi khác .

Bị chặn

Đã vượt quá giới hạn tỷ lệ .

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 ngắt an toàn khói / co

Ngắt khẩn cấp đang có hiệu lự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 không hợp lệ
error Không thể kích hoạt quạt trong khi ngắt an toàn khói / co
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message Không thể kích hoạt quạt trong khi ngắt an toàn khói / co

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

Sản phẩm đã cố gắng thay đổi trạng thái Đi vắng khi Chế độ Nhiệt khẩn cấp đang bật.

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

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

Sự kiện tiết kiệm năng lượng do đối tác năng lượng của Nest xác định đang 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 không hợp lệ
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 Thermostat không hỗ trợ chế độ mà sản phẩm của bạn yêu cầu: heat , cool , 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 không hợp lệ
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 khi đã bật khóa điều chỉnh 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 không hợp lệ
error Không thể thay đổi chế độ HVAC khi đã bật khóa điều chỉnh nhiệt
type https://developers.nest.com/reference/error-messages#lock-enabled
message Không thể thay đổi chế độ HVAC khi đã bật khóa điều chỉnh 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 độ C và độ F 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 không hợp lệ
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 của hệ thống HVAC đã được khởi động (do người dùng thủ công hoặc theo lịch trình, hoặc do chu trình nhiệt / 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ó một hành vi được tích hợp sẵn mà chúng tôi không thể ghi đè thông qua API.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không thể bật / tắt fan_timer_active do chế độ $mode mode không tương thích
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message Không thể bật / tắt fan_timer_active do chế độ $mode mode không tương thích
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 một 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 không hợp lệ
error Không thể đặt fan_timer_duration thành giá trị đã chọn. Xem tham chiếu API để biết 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 tham chiếu API để biết 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 nhiệt đang ở 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 không hợp lệ
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 mục tiêu (ví dụ: nhiệt độ mục target_temperature_high_f ).

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
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_tempether khi chế độ là $ mode

Bộ điều 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 nhiệt / cấu trúc chuyển về chế độ không hạn chế.

Trong thông báo này, $fieldName có thể là bất kỳ giá trị nhiệt độ mục tiêu nào và $mode có thể là bất kỳ giá trị nào trong số: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không thể đặt target_tempether 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

Cần cập nhật chương trình cơ sở 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 chương trình cơ sở hiện tại để đặt Nhiệt độ sinh thái.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Cần cập nhật chương trình cơ sở 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 kể từ khi phát hành.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message Cần cập nhật chương trình cơ sở 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 kể từ khi phát hành.

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Lỗi 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 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 BÂY GIỜ). Để biết thêm thông tin về cách thực hiện cuộc gọi ETA, hãy xem Hướng dẫn Đi vắng & ETA .

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

ETA còn quá xa trong tương lai

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error ETA còn quá xa trong tương lai
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA còn 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 không hợp lệ
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

Bị 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 Bị cấm
type https://developers.nest.com/reference/error-messages#forbidden
message Bị cấm

Lỗi bên trong

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

ID máy ảnh 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 không hợp lệ
error ID máy ảnh không hợp lệ $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message Id máy ảnh không hợp lệ: $id
details $id

Đã gửi nội dung không hợp lệ

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

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

Đường dẫn phâ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 không hợp lệ
error Đường dẫn phân đoạn không hợp lệ: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message Đường dẫn phâ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 không hợp lệ
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

ID cảnh báo khói + co không hợp lệ

smoke_co_alarm_id không hợp lệ.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error ID cảnh báo khói + co không hợp lệ $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message Id cảnh báo khói + co không hợp lệ: $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 không hợp lệ
error Id cấu trúc 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ệ

The thermostat_id không hợp lệ.

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

Giá trị không hợp lệ cho Đi vắng

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 không hợp lệ
error Giá trị không hợp lệ cho Đi vắng
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à các 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 boolean.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
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 ít hơn 256 ký tự

Sản phẩm đã cố gắng tạo nhãn Thermostat có hơn 256 ký tự.

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

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

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Tùy chỉnh tối đa trong đó 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 trong đó vượt quá số lượng $max_where_count
details $max_where_count

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

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Tùy chỉnh tối đa trong đó độ dài tên vượt quá $max_custom_where_name_length
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 vượt quá $max_custom_where_name_length
details $max_custom_where_name_length

Thiếu trường

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Thiếu trường: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Thiếu trường: $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 không hợp lệ
error Thiếu Id ở đâu
type https://developers.nest.com/reference/error-messages#where-id-missing
message Thiếu Id ở đâu

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 không hợp lệ
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

Máy điều nhiệt hiện đang ngoại tuyến. Sau khi bật wi-fi, 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 không hợp lệ
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ị nào được 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 không hợp lệ
error Không có thiết bị nào được ghép nối
type https://developers.nest.com/reference/error-messages#no-paired-devices
message Không có thiết bị nào được 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 không hợp lệ
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ó (các) quyền ghi cho (các) trường

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không có (các) quyền ghi cho (các) trường: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message Không có (các) quyền ghi 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 ĐĂNG được thực hiện khi cần PUT.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
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ố gắng đọ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ế độ Vắng mặt

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không ở chế độ Vắng mặt
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Không ở chế độ Vắng mặt

Không thể ghi

Trường bạn đang cố gắng ghi vào là trường chỉ đọc.

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

Chỉ nơi tên cần được cung cấp

Các trường bổ sung đã được bao gồm trong lệnh gọi wheres .

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

POST không phải là một 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 ĐĂNG được thực hiện khi cần PUT.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error POST không phải là một 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à một loại yêu cầu hợp lệ

Lược đồ vi phạm

Đã xảy ra lỗi khi ghép nối các thiết bị.

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

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 đã cho phép số lượng thiết bị ghép nối tối đa

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

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

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 không hợp lệ
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

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Nhiệt độ C $tempC quá cao đối 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 đối với nhiệt độ khóa $highLockTemp
details $tempC
$highLockTemp

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

Người dùng đã khóa bộ điều nhiệt và sản phẩm đã cố gắng đặt nhiệt độ mục tiêu độ C 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 không hợp lệ
error Nhiệt độ C $tempC quá thấp đối 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 đối 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 độ độ C. Đối với phạm vi nhiệt độ cho phép tính bằng độ C, hãy xem target_temperature_c .

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

Giá trị nhiệt độ C 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 độ độ C. Đối với phạm vi nhiệt độ cho phép tính bằng độ C, hãy xem target_temperature_c .

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

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

Người dùng đã khóa bộ điều nhiệt 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 không hợp lệ
error Nhiệt độ F $tempF quá cao đối 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 đối với nhiệt độ khóa $highLockTemp
details $tempF
$highLockTemp

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

Người dùng đã khóa bộ điều nhiệt 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 không hợp lệ
error Nhiệt độ F $tempF quá thấp đối 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 đối với nhiệt độ khóa $lowLockTemp
details $tempF
$lowLockTemp

Giá trị nhiệt độ F 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. Đối với phạm vi nhiệt độ cho phép tính bằng F, xem target_temperature_f .

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

Giá trị nhiệt độ F 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. Đối với các phạm vi nhiệt độ cho phép tính bằng Fahrenheit, hãy xem mục target_temperature_f .

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

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

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
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

Không thể sửa đổi (các) trường khi cập nhật

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không thể sửa đổi (các) trường khi 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 khi cập nhật: $fieldNames
details $fieldNames

(Các) trường phải sử dụng định dạng ISO 8601

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error (Các) trường phải 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 phải sử dụng định dạng ISO 8601: $fieldNames
details $fieldNames

Máy điều nhiệt không trực tuyến

Máy điều nhiệt hiện đang ngoại tuyến. Sau khi bật wi-fi, 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 không hợp lệ
error Máy điều nhiệt không trực tuyến
type https://developers.nest.com/reference/error-messages#not-online
message Máy điều nhiệt không trực tuyến

Chuyến đi này đã được ghi đè theo cách thủ công

Người dùng đã ghi đè chuyến đi theo cách thủ công.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Chuyến đi này đã được ghi đè theo cách thủ công
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message Chuyến đi này đã được ghi đè theo cách thủ công

Không thể tạo ID nơi

Đối tượng wheres bị thiếu. Không có giá trị where_id nào được xác định.

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Không thể tạo id nơi
type https://developers.nest.com/reference/error-messages#wheres-missing
message Không thể tạo id nơi

Không được phép

Ủy quyền không thành công.

Một số đ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 một triển khai HTTP nhất định không tự động chuyển tiếp tiêu đề Ủy quyền tới 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 các điểm cuối API. Ví dụ: cố gắng đọc điểm cuối Bộ điều nhiệt khi chỉ có quyền Máy ảnh được chọn cho ứng dụng 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 không hợp lệ
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 nhận dạng 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 không hợp lệ
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 không đúng loại

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

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

Nơi tên đã tồn tại

where_name mà 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 không hợp lệ
error Nơi tên $name đã tồn tại
type https://developers.nest.com/reference/error-messages#where-name-exists
message Nơi tên $name đã tồn tại
details $name

Trường hợp 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 không hợp lệ
error Trường hợp tên không được cung cấp
type https://developers.nest.com/reference/error-messages#where-name-missing
message Trường hợp tên không được cung cấp

Trường hợp tên có độ dài bằng 0

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

Thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
error Trường hợp tên có độ dài bằng 0
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message Trường hợp tên có độ dài bằng 0

Trường hợp tên phải là một chuỗi

Đã gửi sai kiểu dữ liệu 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 không hợp lệ
error Trường hợp tên phải là một chuỗi
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Trường hợp 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 không hợp lệ
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

where_id 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 không hợp lệ
error where_id phải là một chuỗi
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id phải là một chuỗi

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

Mã lỗi thiết bị

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

REST mã lỗi

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

REST thông báo giới hạn tỷ lệ

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, hãy xem Giới hạn Tốc độ Dữ liệu .