Notice: We're retiring Works with Nest. See the home page for more information.

Trang này được dịch bởi Cloud Translation API.

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, message và instance. Đố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
`error`	Không thể dùng
`type`	`https://developers.nest.com/reference/error-messages#blocked`
`message`	Khô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ệ
`error`	Không thể kích hoạt quạt trong thời gian tắt hệ thống hút 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 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ệ
`error`	Không thể thay đổi trạng thái Vắng nhà khi chế độ sưởi ấm 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 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ệ
`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ế độ 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ệ
`error`	Không thể thay đổi chế độ HVAC thành `$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 `$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ệ
`error`	Không thể thay đổi chế độ HVAC khi khóa máy điều nhiệt đang bật
`type`	`https://developers.nest.com/reference/error-messages#lock-enabled`
`message`	Khô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ệ
`error`	Không thể đặt đồng thời nhiệt độ C và F
`type`	`https://developers.nest.com/reference/error-messages#multiple-value-changes`
`message`	Khô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ệ
`error`	Không thể đặt bật/tắt quạt_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 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ệ
`error`	Khô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.
`type`	`https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration`
`message`	Khô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ệ
`error`	Không thể đặt nhiệt độ thấp mục tiêu `$lowTemp` cao hơn nhiệt độ cao mục tiêu `$highTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-high-error`
`message`	Khô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ệ
`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_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ệ
`error`	Không thể đặt target_temperature 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`

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ệ
`error`	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. 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.
`type`	`https://developers.nest.com/reference/error-messages#unsupported-firmware-version`
`message`	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. 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ệ
`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à 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ệ
`error`	Giờ đến dự kiến: `$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`type`	`https://developers.nest.com/reference/error-messages#eta-in-the-past`
`message`	Giờ đế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ệ
`error`	ETA trong quá khứ trong tương lai
`type`	`https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future`
`message`	ETA 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ệ
`error`	chưa đặt quạt_timer_active
`type`	`https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing`
`message`	chư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
`error`	Cấm truy cập
`type`	`https://developers.nest.com/reference/error-messages#forbidden`
`message`	Cấ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
`error`	Lỗi nội bộ
`type`	`https://developers.nest.com/reference/error-messages#internal-error`
`message`	Lỗ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ệ
`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`

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ệ
`error`	Nội dung đã gửi không hợp lệ
`type`	`https://developers.nest.com/reference/error-messages#invalid-content-sent`
`message`	Nộ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`
`type`	`https://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ệ
`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`

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ệ
`error`	Id chuông 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`	Mã 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ệ
`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`

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ệ
`error`	Id máy điều nhiệt `$id` không hợp lệ
`type`	`https://developers.nest.com/reference/error-messages#invalid-thermostat-id`
`message`	Id 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ệ
`error`	Giá trị vắng mặt không hợp lệ
`type`	`https://developers.nest.com/reference/error-messages#invalid-away-value`
`message`	Giá 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ệ
`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 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ệ
`error`	Nhãn phải ít hơn `$max_label_length` ký tự
`type`	`https://developers.nest.com/reference/error-messages#max-label-length`
`message`	Nhã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ệ
`error`	Tùy chỉnh tối đa trong đó số lượng `$max_where_count` vượt quá
`type`	`https://developers.nest.com/reference/error-messages#max-where-count`
`message`	Tù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ệ
`error`	Tùy chỉnh tối đa có độ dài tên là `$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 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ệ
`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 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ệ
`error`	Thiếu mã địa điểm
`type`	`https://developers.nest.com/reference/error-messages#where-id-missing`
`message`	Thiế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ệ
`error`	Không có quạt hvac
`type`	`https://developers.nest.com/reference/error-messages#no-hvac-fan`
`message`	Khô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ệ
`error`	Không có máy điều nhiệt trực tuyến
`type`	`https://developers.nest.com/reference/error-messages#no-thermostats-online`
`message`	Khô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ệ
`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.

Các 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ó 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ệ
`error`	Không 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ó 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ệ
`error`	Không phải 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 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
`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 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ệ
`error`	Không ở Chế độ vắng nhà
`type`	`https://developers.nest.com/reference/error-messages#not-in-away-mode`
`message`	Khô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ệ
`error`	Không thể ghi
`type`	`https://developers.nest.com/reference/error-messages#not-writable`
`message`	Khô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ệ
`error`	Chỉ có thể cung cấp tên
`type`	`https://developers.nest.com/reference/error-messages#extra-fields`
`message`	Chỉ 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ệ
`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 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ệ
`error`	Vi phạm giản đồ
`type`	`https://developers.nest.com/reference/error-messages#schema-violation-error`
`message`	Vi 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
`error`	Dịch vụ không khả dụng
`type`	`https://developers.nest.com/reference/error-messages#service-unavailable`
`message`	Dị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ệ
`error`	Cấu trúc đã có số lượng thiết bị đã ghép nối tối đa được phép
`type`	`https://developers.nest.com/reference/error-messages#max-number-devices-error`
`message`	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 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ệ
`error`	Cấu trúc không thuộc quyền 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 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ệ
`error`	Nhiệt độ `$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 độ `$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ệ
`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 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ệ
`error`	Nhiệt độ C quá cao: `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#high-c-value`
`message`	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 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ệ
`error`	Nhiệt độ C quá thấp: `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#low-c-value`
`message`	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 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ệ
`error`	Nhiệt độ `$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 độ `$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ệ
`error`	Nhiệt độ `$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 độ `$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ệ
`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 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ệ
`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 độ 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ệ
`error`	Nhiệt độ `$temp` có định dạng không chính xác
`type`	`https://developers.nest.com/reference/error-messages#format-error`
`message`	Nhiệ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ệ
`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 ở đị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`
`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 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ệ
`error`	Máy điều nhiệt không kết nối mạng
`type`	`https://developers.nest.com/reference/error-messages#not-online`
`message`	Má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ệ
`error`	Chuyến đi này đã bị ghi đè theo cách thủ công
`type`	`https://developers.nest.com/reference/error-messages#trip-manually-overidden`
`message`	Chuyế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ệ
`error`	Không thể tạo vị trí id
`type`	`https://developers.nest.com/reference/error-messages#wheres-missing`
`message`	Khô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
`error`	Không được cho phép
`type`	`https://developers.nest.com/reference/error-messages#auth-error`
`message`	Khô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ệ
`error`	không rõ
`type`	`https://developers.nest.com/reference/error-messages#unknown`
`message`	khô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ệ
`error`	Loại thiết bị/nhà cung cấp không xác định
`type`	`https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error`
`message`	Loạ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ệ
`error`	Giá trị của `$fieldName` thuộc loại sai
`type`	`https://developers.nest.com/reference/error-messages#wrong-data-type`
`message`	Giá 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ệ
`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`

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ệ
`error`	Trong trường hợp tên không được cung cấp
`type`	`https://developers.nest.com/reference/error-messages#where-name-missing`
`message`	Trong 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ệ
`error`	Trong 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`	Trong 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ệ
`error`	Trong 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`	Trong 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ệ
`error`	location_id không tồn tại
`type`	`https://developers.nest.com/reference/error-messages#where-id-invalid`
`message`	location_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ệ
`error`	trong_đây_id phải là một chuỗi
`type`	`https://developers.nest.com/reference/error-messages#where-id-wrong-format`
`message`	trong_đâ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.