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.

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ừ những lỗi đơn giản, như thông số không hợp lệ hoặc bị thiếu cho đến những 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í là chế độ cài đặt liên quan đến thiết bị. Những tình huống này phải được giải quyết bên ngoài API.

Khi lỗi xảy ra trong lệnh 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ả thông báo lỗi đều chứa các trường error, type, messageinstance. Đối tượng details là phần tử không bắt buộc.

Trường Mô tả
error Định dạng thông báo lỗi ngắn.
type Cung cấp URL để biết 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 thông tin chi tiết. Khi một biến được đưa vào thông báo, biến đó sẽ xuất hiện trong đối tượng details.
instance Một chuỗi văn bản lưu giữ giá trị nhận dạng lỗi riêng cho mỗi lệnh gọi. Chúng tôi có thể yêu cầu bạn cung cấp số trường hợp nếu bạn báo cáo vấn đề với dịch vụ.
details Không bắt buộc. Chứa các biến được chèn vào message. Thông báo 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 phần Các thông báo và mã lỗi khác.

Không thể dùng

Đã vượt quá giới hạn tốc độ.

Các thông số
Mã trạng thái HTTP: 429 Có quá nhiều yêu cầu
errorKhông thể dùng
typehttps://developers.nest.com/reference/error-messages#blocked
messageKhông thể dùng

Không thể kích hoạt quạt trong thời gian tắt hệ thống hút khói/co

Tính năng 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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể kích hoạt quạt trong thời gian tắt hệ thống hút khói/co
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageKhông thể kích hoạt quạt trong thời gian tắt hệ thống hút khói/co

Không thể thay đổi trạng thái Vắng nhà khi chế độ sưởi ấm khẩn cấp đang bật

Sản phẩm đã cố gắng thay đổi trạng thái Vắng nhà khi tính năng Khẩn cấp đã bật.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể thay đổi trạng thái Vắng nhà khi chế độ sưởi ấm khẩn cấp đang bật
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageKhông thể thay đổi trạng thái Vắng nhà khi chế độ sưởi ấm 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 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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể thay đổi chế độ HVAC trong các sự kiện tiết kiệm năng lượng
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageKhô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ế độ này 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 sưởi, thông gió và điều hòa không khí (HVAC) của bạn không hỗ trợ chế độ mà sản phẩm yêu cầu: heat, cool, heat-cool hoặc eco
  • Chế độ HVAC được đặt thành eco và sản phẩm sẽ cố gắng đặt target_temperature
Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể thay đổi chế độ HVAC thành $mode; HVAC không thể $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageKhông thể thay đổi chế độ HVAC thành $mode; HVAC không thể $action
details$mode
$action

Không thể thay đổi chế độ HVAC khi khóa máy điều nhiệt đang bật

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể thay đổi chế độ HVAC khi khóa máy điều nhiệt đang bật
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageKhông thể thay đổi chế độ HVAC khi khóa máy điều nhiệt đang bật

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

Sản phẩm cố gắng đặt cả nhiệt độ mục tiêu cho độ C và độ F cùng một lúc. Sản phẩm chỉ nên đặt nhiệt độ mục tiêu do temperature_scale (C/F) xác định.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt đồng thời nhiệt độ C và F
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageKhông thể đặt đồng thời nhiệt độ C và F

Không thể đặt bật/tắt quạt_timer_active do chế độ không tương thích

Quạt hệ thống HVAC đã được người dùng tương tác (theo cách thủ công hoặc theo lịch biểu hoặc do chu kỳ sưởi ấm/làm mát của HVAC).

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt bật/tắt quạt_timer_active do chế độ không tương thích $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageKhông thể đặt bật/tắt quạt_timer_active do chế độ không tương thích $mode
details$mode

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt quạt_timer_duration thành giá trị đã chọn. Hãy tham khảo các giá trị được phép để tham khảo API.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageKhông thể đặt quạt_timer_duration thành giá trị đã chọn. Hãy tham khảo các giá trị được phép để tham khảo API.

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt nhiệt độ thấp mục tiêu $lowTemp cao hơn nhiệt độ cao mục tiêu $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageKhông thể đặt nhiệt độ thấp mục tiêu $lowTemp cao hơn nhiệt độ cao mục tiêu $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ố đặ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ụ: target_temperature_high_f).

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt nhiệt độ mục tiêu gần hơn N độ C/F
typehttps://developers.nest.com/reference/error-messages#range-error
messageKhông thể đặt nhiệt độ mục tiêu gần hơn $min độ $scale
details$min
$scale

Không thể đặt target_temperature trong khi chế độ ở chế độ $mode

Máy điều nhiệt hoặc cấu trúc hiện ở 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 là off hoặc ở chế độ heat-cool. Bạn không thể thay đổi giá trị này cho đến khi máy điều 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 độ 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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể đặt target_temperature trong khi chế độ là $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageKhông thể đặt $fieldName trong khi chế độ là $mode
details$fieldName
$mode

Cần có bản cập nhật chương trình cơ sở của 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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorCần có bản cập nhật chương trình cơ sở của thiết bị trước khi bạn có thể thay đổi chế độ HVAC. Các bản cập nhật được tự động, thường trong vòng một tuần kể từ khi phát hành.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageCần có bản cập nhật chương trình cơ sở của thiết bị trước khi bạn có thể thay đổi chế độ HVAC. Các bản cập nhật được 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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorLỗi khi xác thực các trường WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageLỗi khi xác thực các trường WWN: $error
details$error

ETA là ngày trong quá khứ

Thời gian đến dự kiến được chỉ định là ngày trong quá khứ (trước NGAY 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 về việc đi làm và đến khách hàng. ETA.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorGiờ đến dự kiến: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageGiờ đến dự kiến: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

ETA trong quá khứ trong tương lai

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorETA trong quá khứ trong tương lai
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageETA trong quá khứ trong tương lai

chưa đặt quạt_timer_active

fan_timer_active chưa được xác định.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorchưa đặt quạt_timer_active
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagechưa đặt quạt_timer_active

Cấm truy cập

Thông tin xác thực dùng để truy cập vào dịch vụ Nest là không hợp lệ.

Các thông số
Mã trạng thái HTTP: 403 Forbidden
errorCấm truy cập
typehttps://developers.nest.com/reference/error-messages#forbidden
messageCấm truy cập

Lỗi nội bộ

Các thông số
Mã trạng thái HTTP: Lỗi máy chủ nội bộ 500
errorLỗi nội bộ
typehttps://developers.nest.com/reference/error-messages#internal-error
messageLỗi nội bộ

ID máy ảnh không hợp lệ

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorId máy ảnh không hợp lệ $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageId máy ảnh không hợp lệ: $id
details$id

Nội dung đã gửi 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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNội dung đã gửi không hợp lệ
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageNội dung đã gửi không hợp lệ

Đường dẫn mảnh 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ụ: có thể viết sai tên đối tượng hoặc trường.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorĐường dẫn mảnh không hợp lệ: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageĐường dẫn mảnh không hợp lệ: $requestPath
details$requestPath

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorChế độ HVAC không hợp lệ: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageChế độ HVAC không hợp lệ: $mode
details$mode

Mã chuông báo khói + đồng không hợp lệ

smoke_co_alarm_id không hợp lệ.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorId chuông báo khói+co không hợp lệ $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageMã chuông báo khói + đồng không hợp lệ: $id
details$id

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

structure_id không hợp lệ.

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

Mã máy điều nhiệt không hợp lệ

thermostat_id không hợp lệ.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorId máy điều nhiệt $id không hợp lệ
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageId máy điều nhiệt không hợp lệ: $id
details$id

Giá trị vắng mặt không hợp lệ

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorGiá trị vắng mặt không hợp lệ
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageGiá trị không hợp lệ: $value. Chỉ &\39;home\39; và 'cách nhà\39; là các giá trị được phép.
details$value

is_streaming không phải là boolean

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
erroris_streaming không phải là boolean
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_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 nhiệt với hơn 256 ký tự.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhãn phải ít hơn $max_label_length ký tự
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageNhãn phải í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 các đối tượng wheres tùy chỉnh tối đa được phép là 32.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorTùy chỉnh tối đa trong đó số lượng $max_where_count vượt quá
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageTùy chỉnh tối đa trong đó số lượng $max_where_count vượt quá
details$max_where_count

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

Địa điểm name quá dài. Chúng tôi khuyến khích sử dụng ít hơn 30 ký tự.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorTùy chỉnh tối đa có độ dài tên là $max_custom_where_name_length vượt quá
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageTùy chỉnh tối đa có độ dài tên là $max_custom_where_name_length vượt quá
details$max_custom_where_name_length

Thiếu trường

Cuộc gọi thiếu một thông số bắt buộc.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorThiếu trường: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageThiếu trường: $fieldName
details$fieldName

Thiếu mã vị trí

Thiếu định dạng where_id.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorThiếu mã địa điểm
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageThiếu mã địa điểm

Không có quạt HVAC

Hệ thống sưởi, thông gió và điều hòa có vẻ không có quạt độc lập.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông có quạt hvac
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageKhông có quạt hvac

Không có máy điều nhiệt trực tuyến

Máy điều nhiệt hiện không kết nối mạng. Sau khi bật Wi-Fi, sản phẩm của bạn sẽ lấy lại quyền truy cập.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông có máy điều nhiệt trực tuyến
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageKhông có máy điều nhiệt trực tuyến

Không có thiết bị nào được ghép nối

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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông có thiết bị nào được ghép nối
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageKhô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.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông có ETA hợp lệ để hủy
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageKhông có ETA hợp lệ để hủy

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

Ứng dụng không có quyền ghi đối với dữ liệu này. Để biết thêm thông tin, hãy xem bài viết Tổng quan về quyền.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông có quyền ghi cho (các) trường: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageKhông có quyền ghi cho (các) trường: $fields
details$fields

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông phải loại yêu cầu hợp lệ: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageKhông phải 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.

Các thông số
Mã trạng thái HTTP: Không tìm thấy mã 404
errorKhông tìm thấy
typehttps://developers.nest.com/reference/error-messages#not-found
messageKhông tìm thấy

Không ở Chế độ vắng nhà

Cấu trúc này không ở chế độ Vắng nhà khi có lệnh gọi ETA. Cuộc gọi ETA chỉ được chấp nhận khi cấu trúc được đặt thành Vắng nhà.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông ở Chế độ vắng nhà
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageKhông ở Chế độ vắng nhà

Không thể ghi

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

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

Chỉ có thể cung cấp tên

Các trường bổ sung đã được đưa vào lệnh gọi wheres.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorChỉ có thể cung cấp tên
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageChỉ có thể 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ụ: cuộc gọi POST được thực hiện khi PUT là bắt buộc.

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

Vi phạm giản đồ

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorVi phạm giản đồ
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageVi phạm giản đồ

Dịch vụ không dùng được

Các thông số
Mã trạng thái HTTP: Không có dịch vụ 503
errorDịch vụ không khả dụng
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageDịch vụ không khả dụng

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

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

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

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

structure_id không khớp với tài khoản người dùng trong bản ghi.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorCấu trúc không thuộc quyền sở hữu của người dùng.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageCấu trúc không thuộc quyền 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 máy điều nhiệt và sản phẩm đã cố đặt nhiệt độ mục tiêu cho độ C cao hơn phạm vi nhiệt độ khóa.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ $tempC quá cao so với nhiệt độ khóa $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageNhiệt độ $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

Máy điều nhiệt đã bị người dùng khóa và sản phẩm đã cố đặt nhiệt độ mục tiêu thấp hơn độ C.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ C $tempC quá thấp so với nhiệt độ khóa $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageNhiệ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 cho nhiệt độ độ C. Để biết phạm vi nhiệt độ cho phép ở độ C, hãy xem target_temperature_c.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ C quá cao: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageNhiệ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 cho nhiệt độ độ C. Để biết phạm vi nhiệt độ cho phép ở độ C, hãy xem target_temperature_c.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ C quá thấp: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageNhiệ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 máy điều nhiệt và sản phẩm đã cố đặt nhiệt độ mục tiêu bằng độ F cao hơn phạm vi nhiệt độ khóa.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ $tempF quá cao so với nhiệt độ khóa $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageNhiệt độ $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

Người dùng đã khóa máy điều nhiệt và sản phẩm đã cố đặt nhiệt độ mục tiêu ở độ F thấp hơn phạm vi nhiệt độ khóa.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ $tempF quá thấp so với nhiệt độ khóa $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageNhiệt độ $tempF quá thấp so 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 một giá trị nhiệt độ mục tiêu quá cao cho nhiệt độ độ. Để biết phạm vi nhiệt độ cho phép ở độ F, hãy xem target_temperature_f.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorGiá trị nhiệt độ F quá cao: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageGiá 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 cho nhiệt độ độ. Để biết phạm vi nhiệt độ cho phép ở độ F, hãy xem target_temperature_f.

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

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNhiệt độ $temp có định dạng không chính xác
typehttps://developers.nest.com/reference/error-messages#format-error
messageNhiệt độ $temp có định dạng không chính xác
details$temp

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể sửa đổi(các) trường khi cập nhật: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageKhô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 ở định dạng ISO 8601.

Các 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
typehttps://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 kết nối mạng

Máy điều nhiệt hiện không kết nối mạng. Sau khi bật Wi-Fi, sản phẩm của bạn sẽ lấy lại quyền truy cập.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorMáy điều nhiệt không kết nối mạng
typehttps://developers.nest.com/reference/error-messages#not-online
messageMáy điều nhiệt không kết nối mạng

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

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

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

Không thể tạo vị trí ID

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorKhông thể tạo vị trí id
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageKhông thể tạo vị trí id

Không được cho phép

Uỷ quyền không thành công.

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

  • hành vi chuyển hướng không chính xác xảy ra khi một hoạt động triển khai HTTP nhất định không tự động chuyển tiếp tiêu đề Uỷ quyền đến URI được chuyển hướng. Để biết thêm thông tin, hãy xem bài viết Cách xử lý các lệnh chuyển hướng.

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

Các thông số
Mã trạng thái HTTP: 401 Không được phép
errorKhông được cho phép
typehttps://developers.nest.com/reference/error-messages#auth-error
messageKhông được cho phép

Không xác định

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorkhông rõ
typehttps://developers.nest.com/reference/error-messages#unknown
messagekhông rõ

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

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorLoại thiết bị/nhà cung cấp không xác định
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageLoại thiết bị/nhà cung cấp không xác định

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

Bạn đã gửi sai dữ liệu. Ví dụ: gửi một chuỗi khi dự kiến boolean.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorGiá trị của $fieldName thuộc loại sai
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageGiá trị của $fieldName thuộc loại sai
details$fieldName

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 bằng một tên mới.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorNơi tên $name đã tồn tại
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageNơi tên $name đã tồn tại
details$name

Trong trường hợp tên không được cung cấp

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorTrong trường hợp tên không được cung cấp
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageTrong trường hợp tên không được cung cấp

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

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

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

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

Bạn đã gửi sai loại dữ liệu cho where_name. Ví dụ: một số dự kiến khi chuỗi.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorTrong trường hợp tên phải là một chuỗi
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageTrong trường hợp tên phải là một chuỗi

location_id không tồn tại

where_id không hợp lệ.

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errorlocation_id không tồn tại
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagelocation_id không tồn tại
details$where_id

trong_đây_id phải là một chuỗi

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

Các thông số
Mã trạng thái HTTP: 400 Yêu cầu không hợp lệ
errortrong_đây_id phải là một chuỗi
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagetrong_đây_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ị

Đối với các 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 các nội dung sau:

Mã lỗi REST

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

Thông báo giới hạn tốc độ REST

Khi sử dụng REST và gửi quá nhiều lệnh 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 bài viết về Hạn mức tốc độ dữ liệu.