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ặceco
- Chế độ HVAC được đặt thành
eco
và sản phẩm sẽ cố gắng đặttarget_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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.