پیام های خطا، پیام های خطا

شرایط خطا بخشی از چرخه توسعه است و می‌تواند از خطاهای ساده، مانند یک پارامتر نامعتبر یا گمشده، تا سناریوهای پیچیده‌تر، مانند وضعیت غیرمنتظره یا حتی تنظیمات مرتبط با دستگاه، که باید خارج از API حل شوند، متغیر باشد.

هنگامی که در طول تماس API خطایی رخ می دهد، پاسخی در این قالب ارسال می شود:

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

همه پیام های خطا شامل فیلدهای error ، type ، message و instance هستند. شی details اختیاری است.

رشته شرح
error قالب پیام خطای کوتاه
type یک URL برای اطلاعات دقیق در مورد شرایط خطا ارائه می دهد (این صفحه).
message قالب پیام خطای طولانی که ممکن است از متغیرها برای ارائه جزئیات بیشتر استفاده کند. هنگامی که یک متغیر در پیام گنجانده می شود، در شی details ظاهر می شود.
instance یک رشته متنی که دارای شناسه خطا است که برای هر تماس فردی منحصر به فرد است. در صورت گزارش مشکلی در سرویس، ممکن است از شما شماره نمونه را بخواهیم.
details اختیاری. شامل متغیرهایی است که در message درج می شوند. پیام ها می توانند شامل چندین متغیر باشند.

برای اطلاعات در مورد خطاهایی که به Nest API مرتبط نیستند، به سایر کدهای خطا و پیام‌ها مراجعه کنید.

مسدود

از حد مجاز فراتر رفته است.

مولفه های
کد وضعیت HTTP: 429 درخواست خیلی زیاد
error مسدود
type https://developers.nest.com/reference/error-messages#blocked
message مسدود

نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد

خاموشی اضطراری در حال اجرا است. تماس های API تا زمانی که عملکرد عادی بازیابی نشود پذیرفته نمی شود.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد

وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد

وقتی گرمای اضطراری روشن بود، محصول سعی کرد حالت دور را تغییر دهد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد

نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد

یک رویداد صرفه جویی در مصرف انرژی که توسط شریک انرژی Nest تعریف شده است در حال اجرا است. تماس‌های API تا پایان رویداد صرفه‌جویی در مصرف انرژی رد می‌شوند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد

نمی توان حالت HVAC را تغییر داد

حالت با درخواست ناسازگار است.

برای مثال، ممکن است این پیام را دریافت کنید اگر:

  • سیستم تهویه مطبوع ترموستات از حالت درخواستی محصول شما پشتیبانی نمی کند: heat ، cool ، heat-cool ، یا eco
  • حالت HVAC روی eco تنظیم شده است و محصول سعی می کند target_temperature را تنظیم کند
مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان حالت HVAC را به $mode تغییر داد. HVAC نمی‌تواند $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message نمی توان حالت HVAC را به $mode تغییر داد. HVAC نمی‌تواند $action
details $mode
$action

وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد

قبل از اینکه محصولی بتواند داده بنویسد، کاربر باید قفل ترموستات را باز کند .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد
type https://developers.nest.com/reference/error-messages#lock-enabled
message وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد

نمی توان دمای C و F را به طور همزمان تنظیم کرد

این محصول سعی کرد دمای هدف را به صورت همزمان درجه سانتیگراد و فارنهایت تنظیم کند. یک محصول باید فقط دمای مورد نظر تعیین شده توسط temperature_scale حرارت_مقیاس (C/F) را تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای C و F را به طور همزمان تنظیم کرد
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message نمی توان دمای C و F را به طور همزمان تنظیم کرد

به دلیل حالت ناسازگار، نمی توان fan_timer_active را روشن/خاموش کرد

فن سیستم تهویه مطبوع از قبل فعال شده است (به صورت دستی توسط کاربر، یا بر اساس یک برنامه، یا به دلیل چرخه گرما/خنک کردن HVAC).

اگر نتیجه مورد انتظار را دریافت نکردید، به احتمال زیاد به این دلیل است که دستگاه دارای یک رفتار داخلی است که ما نمی توانیم از طریق API آن را لغو کنیم.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان fan_timer_active را روشن/خاموش کرد زیرا حالت $mode mode ناسازگار است
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message نمی توان fan_timer_active را روشن/خاموش کرد زیرا حالت $mode mode ناسازگار است
details $mode

نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد

محصول سعی کرد fan_timer_duration را روی یک مقدار نامعتبر تنظیم کند. برای لیستی از مقادیر معتبر به fan_timer_duration مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد. برای مقادیر مجاز به مرجع API مراجعه کنید.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد. برای مقادیر مجاز به مرجع API مراجعه کنید.

نمی توان دمای پایین هدف را بالاتر از دمای بالای هدف قرار داد

ترموستات در حالت heat-cool است، و محصول سعی کرد دمای هدف را کم/بالا تنظیم کند که خارج از محدوده باشد. به عنوان مثال، محصول سعی کرد target_temperature_low_c را روی 25 درجه سانتیگراد تنظیم کند، زمانی که target_temperature_high_c 24 درجه سانتیگراد است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای پایین $lowTemp بالاتر از دمای بالای هدف $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message نمی توان دمای پایین $lowTemp بالاتر از دمای بالای هدف $highTemp
details $lowTemp
$highTemp

نمی توان دمای هدف را نزدیک تر از N درجه سانتی گراد تنظیم کرد

محصول سعی کرد یک مقدار دمای هدف را خیلی نزدیک به دمای بالا/پایین هدف تنظیم کند (به عنوان مثال، target_temperature_high_f ).

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای هدف را نزدیک تر از N درجه سانتی گراد تنظیم کرد
type https://developers.nest.com/reference/error-messages#range-error
message نمی توان دمای هدف را نزدیکتر از $min درجه $scale تنظیم کرد
details $min
$scale

در حالت $mode نمی توان target_temperature را تنظیم کرد

ترموستات یا ساختار در حال حاضر در حالتی است که از درخواست‌های API پشتیبانی نمی‌کند.

به عنوان مثال، نمی توانید target_temperature_f یا target_temperature_c را هنگامی که سیستم HVAC off است یا در حالت heat-cool کنید. تا زمانی که ترموستات/ساختار به حالت غیرمحدود برگردد، نمی‌توان مقدار را تغییر داد.

در این پیام، $fieldName می‌تواند هر یک از مقادیر دمای مورد نظر باشد و $mode می‌تواند یکی از موارد زیر باشد: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error در حالت $mode نمی توان target_temperature را تنظیم کرد
type https://developers.nest.com/reference/error-messages#mode-error
message نمی توان $fieldName در حالی که حالت $mode تنظیم کرد
details $fieldName
$mode

قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است

برای تنظیم دمای اکو، دستگاه باید به نسخه سفت‌افزار فعلی به‌روزرسانی شود.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است. به‌روزرسانی‌ها به‌طور خودکار انجام می‌شوند، معمولاً ظرف یک هفته پس از انتشار.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است. به‌روزرسانی‌ها به‌طور خودکار انجام می‌شوند، معمولاً ظرف یک هفته پس از انتشار.

خطا هنگام تأیید فیلدهای WWN

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error خطا هنگام تأیید فیلدهای WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message خطا هنگام تأیید فیلدهای WWN: $error
details $error

ایتا در گذشته است

زمان ETA مشخص شده در گذشته (قبل از NOW) است. برای اطلاعات بیشتر در مورد برقراری تماس های ETA، به راهنمای خارج از خانه و ETA مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA در گذشته است: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA در گذشته است: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA در آینده بسیار دور است

زمان ETA مشخص شده در آینده نمی تواند بیش از 8 ساعت باشد. برای اطلاعات بیشتر در مورد برقراری تماس های ETA، به راهنمای خارج از خانه و ETA مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA در آینده بسیار دور است
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA در آینده بسیار دور است

fan_timer_active تنظیم نشده است

fan_timer_active تعریف نشده است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error fan_timer_active تنظیم نشده است
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active تنظیم نشده است

ممنوع

اعتبارنامه‌هایی که برای دسترسی به سرویس Nest استفاده می‌شوند، نامعتبر هستند.

مولفه های
کد وضعیت HTTP: 403 ممنوع
error ممنوع
type https://developers.nest.com/reference/error-messages#forbidden
message ممنوع

خطای داخلی

مولفه های
کد وضعیت HTTP: 500 خطای سرور داخلی
error خطای داخلی
type https://developers.nest.com/reference/error-messages#internal-error
message خطای داخلی

شناسه دوربین نامعتبر است

camera-id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه دوربین $id نامعتبر است
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message شناسه دوربین نامعتبر: $id
details $id

محتوای نامعتبر ارسال شد

تماس حاوی محتوای نامعتبر است. به عنوان مثال، استفاده از "yes" به جای "true" برای یک متغیر بولی.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error محتوای نامعتبر ارسال شد
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message محتوای نامعتبر ارسال شد

مسیر قطعه نامعتبر است

بخشی از مسیر درخواست نامعتبر است. به عنوان مثال، نام یک شی یا فیلد ممکن است اشتباه املایی داشته باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مسیر قطعه نامعتبر: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message مسیر قطعه نامعتبر: $requestPath
details $requestPath

حالت HVAC نامعتبر است

سیستم تهویه مطبوع ترموستات از حالت درخواستی محصول پشتیبانی نمی کند: heat ، سرما، یا heat-cool cool

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حالت HVAC نامعتبر: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message حالت HVAC نامعتبر: $mode
details $mode

شناسه هشدار دود + co نامعتبر است

smoke_co_alarm_id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه زنگ دود + co نامعتبر $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message شناسه هشدار smoke+co نامعتبر است: $id
details $id

شناسه ساختار نامعتبر است

structure_id id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه ساختار نامعتبر $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message شناسه ساختار نامعتبر: $id
details $id

شناسه ترموستات نامعتبر است

thermostat_id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه ترموستات $id نامعتبر است
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message شناسه ترموستات نامعتبر: $id
details $id

مقدار نامعتبر برای Away

شما سعی کردید یک مقدار نامعتبر برای away تنظیم کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار نامعتبر برای Away
type https://developers.nest.com/reference/error-messages#invalid-away-value
message مقدار نامعتبر: $value . فقط «خانه» و «خارج» مقادیر مجاز هستند.
details $value

is_streaming منطقی نیست

محصول سعی کرد فیلد is-streaming را روی یک غیر بولی تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error is_streaming منطقی نیست
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming منطقی نیست

برچسب باید کمتر از 256 کاراکتر باشد

این محصول سعی کرد یک برچسب ترموستات با بیش از 256 کاراکتر ایجاد کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error برچسب باید کمتر از نویسه $max_label_length باشد
type https://developers.nest.com/reference/error-messages#max-label-length
message برچسب باید کمتر از نویسه $max_label_length باشد
details $max_label_length

حداکثر سفارشی در جایی که تعداد بیش از آن است

محصول سعی کرد یک wheres سفارشی ایجاد کند که در آن شی فراتر از حداکثر باشد. حداکثر تعداد سفارشی که در آن اشیاء wheres هستند 32 عدد است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حداکثر سفارشی که در آن تعداد $max_where_count بیشتر شد
type https://developers.nest.com/reference/error-messages#max-where-count
message حداکثر سفارشی که در آن تعداد $max_where_count بیشتر شد
details $max_where_count

حداکثر سفارشی در جایی که طول نام بیشتر شده است

name جایی که خیلی طولانی است. ما کمتر از 30 کاراکتر را توصیه می کنیم.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حداکثر سفارشی که در آن طول نام از $max_custom_where_name_length بیشتر شود
type https://developers.nest.com/reference/error-messages#max-where-name-length
message حداکثر سفارشی که در آن طول نام از $max_custom_where_name_length بیشتر شود
details $max_custom_where_name_length

میدان گم شده

فراخوان یک پارامتر لازم را ندارد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error فیلد وجود ندارد: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message فیلد وجود ندارد: $fieldName
details $fieldName

شناسه کجا وجود ندارد

قالب where_id .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه کجا وجود ندارد
type https://developers.nest.com/reference/error-messages#where-id-missing
message شناسه کجا وجود ندارد

بدون فن HVAC

به نظر نمی رسد که سیستم HVAC دارای فن مستقل باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error بدون فن hvac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message بدون فن hvac

بدون ترموستات آنلاین

ترموستات در حال حاضر آفلاین است. پس از فعال شدن وای فای، محصول شما باید دوباره دسترسی پیدا کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error بدون ترموستات آنلاین
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message بدون ترموستات آنلاین

هیچ دستگاه جفت شده ای وجود ندارد

دستگاه‌های Nest کاربر با حساب Nest کاربر جفت نشده‌اند .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error هیچ دستگاه جفت شده ای وجود ندارد
type https://developers.nest.com/reference/error-messages#no-paired-devices
message هیچ دستگاه جفت شده ای وجود ندارد

ETA معتبری برای لغو وجود ندارد

این سفر معتبر نیست و قابل لغو نیست.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA معتبری برای لغو وجود ندارد
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message ETA معتبری برای لغو وجود ندارد

بدون مجوز(های) نوشتن برای فیلد(ها)

مشتری مجوز نوشتن برای این داده ها را ندارد. برای اطلاعات بیشتر، به نمای کلی مجوزها مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error بدون مجوز(های) نوشتن برای فیلد(ها): $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message بدون مجوز(های) نوشتن برای فیلد(ها): $fields
details $fields

یک نوع درخواست معتبر نیست

نوع درخواست معتبر نیست. به عنوان مثال، هنگامی که یک PUT مورد نیاز است، یک تماس POST برقرار شد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error یک نوع درخواست معتبر نیست: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message یک نوع درخواست معتبر نیست: $requestType
details $requestType

پیدا نشد

تماس سعی کرد مسیری را بخواند که وجود ندارد.

مولفه های
کد وضعیت HTTP: 404 یافت نشد
error پیدا نشد
type https://developers.nest.com/reference/error-messages#not-found
message پیدا نشد

در حالت دور نیست

هنگام برقراری تماس ETA، ساختار در حالت Away نیست. تماس های ETA تنها زمانی پذیرفته می شوند که ساختار روی Away تنظیم شده باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error در حالت دور نیست
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message در حالت دور نیست

قابل نوشتن نیست

فیلدی که می‌خواهید در آن بنویسید فقط خواندنی است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error قابل نوشتن نیست
type https://developers.nest.com/reference/error-messages#not-writable
message قابل نوشتن نیست

فقط در جایی که باید نام ارائه شود

فیلدهای اضافی در تماس wheres گنجانده شد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error فقط در جایی که باید نام ارائه شود
type https://developers.nest.com/reference/error-messages#extra-fields
message فقط در جایی که باید نام ارائه شود

POST یک نوع درخواست معتبر نیست

نوع درخواست نامعتبر است. به عنوان مثال، هنگامی که یک PUT مورد نیاز است، یک تماس POST برقرار شد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error POST یک نوع درخواست معتبر نیست
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST یک نوع درخواست معتبر نیست

نقض طرحواره

هنگام جفت شدن دستگاه ها خطایی روی داد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نقض طرحواره
type https://developers.nest.com/reference/error-messages#schema-violation-error
message نقض طرحواره

سرویس در دسترس نیست

مولفه های
کد وضعیت HTTP: سرویس 503 در دسترس نیست
error سرویس در دسترس نیست
type https://developers.nest.com/reference/error-messages#service-unavailable
message سرویس در دسترس نیست

ساختار از قبل دارای حداکثر تعداد مجاز دستگاه‌های جفت شده است

ساختار از قبل دارای حداکثر تعداد دستگاه های مجاز است .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ساختار از قبل دارای حداکثر تعداد مجاز دستگاه‌های جفت شده است
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message ساختار از قبل دارای حداکثر تعداد مجاز دستگاه‌های جفت شده است

ساختار متعلق به کاربر نیست

structure_id id با حساب کاربری رکورد مطابقت ندارد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ساختار متعلق به کاربر نیست.
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message ساختار متعلق به کاربر نیست.

دمای C برای دمای قفل خیلی زیاد است

ترموستات توسط کاربر قفل شده است و محصول سعی کرده است دمای مورد نظر درجه سانتیگراد را بالاتر از محدوده دمای قفل تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error دمای C $tempC برای دمای قفل $highLockTemp خیلی زیاد است
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message دمای C $tempC برای دمای قفل $highLockTemp خیلی زیاد است
details $tempC
$highLockTemp

دمای C برای دمای قفل بسیار پایین است

ترموستات توسط کاربر قفل شده است و محصول سعی کرده است دمای مورد نظر درجه سانتیگراد را کمتر از محدوده دمای قفل تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error دمای C $tempC برای دمای قفل $lowLockTemp بسیار پایین است
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message دمای C $tempC برای دمای قفل $lowLockTemp بسیار پایین است
details $tempC
$lowLockTemp

مقدار دمای C خیلی زیاد است

محصول سعی کرد یک مقدار دمای هدف را تنظیم کند که برای دمای سانتیگراد خیلی زیاد است. برای محدوده دمای مجاز بر حسب سلسیوس، target_temperature_c را ببینید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار دمای C خیلی زیاد است: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message مقدار دمای C خیلی زیاد است: $tempC
details $tempC

مقدار دمای C خیلی پایین است

محصول سعی کرد یک مقدار دمای هدف را تنظیم کند که برای دمای سانتیگراد خیلی پایین است. برای محدوده دمای مجاز بر حسب سلسیوس، target_temperature_c را ببینید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار دمای C بسیار پایین است: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message مقدار دمای C بسیار پایین است: $tempC
details $tempC

دمای F برای دمای قفل خیلی زیاد است

ترموستات توسط کاربر قفل شده است و محصول سعی کرده دمای هدف فارنهایت را بالاتر از محدوده دمای قفل تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error دمای F $tempF برای دمای قفل $highLockTemp خیلی زیاد است
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message دمای F $tempF برای دمای قفل $highLockTemp خیلی زیاد است
details $tempF
$highLockTemp

دمای F برای دمای قفل بسیار پایین است

ترموستات توسط کاربر قفل شده است و محصول سعی کرده دمای هدف فارنهایت را کمتر از محدوده دمای قفل تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error دمای F $tempF برای دمای قفل $lowLockTemp بسیار پایین است
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message دمای F $tempF برای دمای قفل $lowLockTemp بسیار پایین است
details $tempF
$lowLockTemp

مقدار درجه حرارت F خیلی زیاد است

محصول سعی کرد یک مقدار دمای هدف را تنظیم کند که برای دمای فارنهایت خیلی زیاد است. برای محدوده دمای مجاز در فارنهایت، target_temperature_f را ببینید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار F بسیار زیاد است: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message مقدار F بسیار زیاد است: $tempF
details $tempF

مقدار درجه حرارت F خیلی پایین است

محصول سعی کرد یک مقدار دمای هدف را تنظیم کند که برای دمای فارنهایت بسیار پایین است. برای محدوده دمای مجاز در فارنهایت، target_temperature_f را ببینید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار F بسیار پایین است: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message مقدار F بسیار پایین است: $tempF
details $tempF

دما در فرمت اشتباه است

محصول سعی کرد دمای مورد نظر را با استفاده از قالب عددی اشتباه برای temperature_scale انتخابی تنظیم کند. دماهای سلسیوس باید اعداد صحیح با افزایش 0.5 درجه (21.5) و دمای فارنهایت باید اعداد صحیح کامل (72) باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error دمای $temp در قالب اشتباه است
type https://developers.nest.com/reference/error-messages#format-error
message دمای $temp در قالب اشتباه است
details $temp

فیلد(ها) را نمی توان در به روز رسانی تغییر داد

محصول سعی کرد در یک فیلد فقط خواندنی بنویسد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error فیلد(ها) را نمی توان در به روز رسانی تغییر داد: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message فیلد(ها) را نمی توان در به روز رسانی تغییر داد: $fieldNames
details $fieldNames

فیلدها باید از فرمت ISO 8601 استفاده کنند

این فیلد در قالب ISO 8601 نیست.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error فیلد(ها) باید از فرمت ISO 8601 استفاده کند: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message فیلد(ها) باید از فرمت ISO 8601 استفاده کند: $fieldNames
details $fieldNames

ترموستات آنلاین نیست

ترموستات در حال حاضر آفلاین است. پس از فعال شدن وای فای، محصول شما باید دوباره دسترسی پیدا کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ترموستات آنلاین نیست
type https://developers.nest.com/reference/error-messages#not-online
message ترموستات آنلاین نیست

این سفر به صورت دستی لغو شده است

کاربر به صورت دستی سفر را لغو کرده است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error این سفر به صورت دستی لغو شده است
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message این سفر به صورت دستی لغو شده است

شناسه مکان ایجاد نشد

شی wheres گم شده است. هیچ مقدار where_id تعریف نشده است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه مکان ایجاد نشد
type https://developers.nest.com/reference/error-messages#wheres-missing
message شناسه مکان ایجاد نشد

غیرمجاز

مجوز انجام نشد.

چند شرط ممکن است این پیام خطا را ایجاد کند:

  • ریدایرکت‌های نادرست زمانی اتفاق می‌افتند که یک پیاده‌سازی HTTP معین، هدر مجوز را به‌طور خودکار به URI هدایت‌شده ارسال نمی‌کند. برای اطلاعات بیشتر، نحوه رسیدگی به تغییر مسیرها را ببینید.

  • مجوزهای نادرست هنگام تلاش برای دسترسی به نقاط پایانی API. برای مثال، تلاش برای خواندن نقطه پایانی ترموستات زمانی که فقط مجوزهای دوربین برای مشتری انتخاب شده است. برای اطلاعات بیشتر، نحوه انتخاب مجوزها را ببینید.

مولفه های
کد وضعیت HTTP: 401 غیر مجاز
error غیرمجاز
type https://developers.nest.com/reference/error-messages#auth-error
message غیرمجاز

ناشناس

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ناشناس
type https://developers.nest.com/reference/error-messages#unknown
message ناشناس

نوع فروشنده/دستگاه ناشناس

فروشنده/دستگاه در طول جفت شدن دستگاه شناسایی نشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نوع فروشنده/دستگاه ناشناس
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message نوع فروشنده/دستگاه ناشناس

مقدار $fieldName از نوع اشتباه است

نوع داده اشتباه ارسال شده است. به عنوان مثال، ارسال یک رشته زمانی که انتظار می رود یک بولی وجود داشته باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار $fieldName از نوع اشتباه است
type https://developers.nest.com/reference/error-messages#wrong-data-type
message مقدار $fieldName از نوع اشتباه است
details $fieldName

جایی که نام از قبل وجود دارد

where_name محصولی که سعی کرد تنظیم کند از قبل وجود دارد. دوباره با نام جدید امتحان کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error جایی که نام $name از قبل وجود دارد
type https://developers.nest.com/reference/error-messages#where-name-exists
message جایی که نام $name از قبل وجود دارد
details $name

جایی که نام ارائه نشده است

where_name در تماس وجود ندارد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error جایی که نام ارائه نشده است
type https://developers.nest.com/reference/error-messages#where-name-missing
message جایی که نام ارائه نشده است

جایی که نام با طول صفر باشد

name جایی که تعریف نشده است (صفر کاراکتر دارد).

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error جایی که نام با طول صفر باشد
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message جایی که نام با طول صفر باشد

جایی که نام باید یک رشته باشد

نوع داده اشتباهی برای where_name ارسال شد. به عنوان مثال، یک عدد زمانی که یک رشته مورد انتظار است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error جایی که نام باید یک رشته باشد
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message جایی که نام باید یک رشته باشد

Where_id وجود ندارد

where_id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error Where_id وجود ندارد
type https://developers.nest.com/reference/error-messages#where-id-invalid
message Where_id وجود ندارد
details $where_id

Where_id باید یک رشته باشد

قالب where_id نامعتبر است. به عنوان مثال، یک عدد به جای یک رشته ارسال شد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error Where_id باید یک رشته باشد
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message Where_id باید یک رشته باشد

سایر کدهای خطا و پیام ها

کدهای خطای دستگاه

برای کدهای خطای خاص دستگاه و پیام‌های غیرمرتبط با Nest API، موارد زیر را ببینید:

کدهای خطا REST

وقتی یک تماس REST API برقرار می کنید، کدهای وضعیت معمول HTTP برگردانده می شوند.

پیام های محدودیت نرخ REST

هنگامی که از REST استفاده می کنید و در مدت زمان کوتاهی تماس های زیادی ارسال می کنید، ممکن است کد وضعیت پاسخ HTTP با 429 درخواست خیلی زیاد دریافت کنید.

برای اطلاعات بیشتر، محدودیت‌های نرخ داده را ببینید.

،

شرایط خطا بخشی از چرخه توسعه است و می‌تواند از خطاهای ساده، مانند یک پارامتر نامعتبر یا گمشده، تا سناریوهای پیچیده‌تر، مانند وضعیت غیرمنتظره یا حتی تنظیمات مرتبط با دستگاه، که باید خارج از API حل شوند، متغیر باشد.

هنگامی که در طول تماس API خطایی رخ می دهد، پاسخی در این قالب ارسال می شود:

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

همه پیام های خطا شامل فیلدهای error ، type ، message و instance هستند. شی details اختیاری است.

رشته شرح
error قالب پیام خطای کوتاه
type یک URL برای اطلاعات دقیق در مورد شرایط خطا ارائه می دهد (این صفحه).
message قالب پیام خطای طولانی که ممکن است از متغیرها برای ارائه جزئیات بیشتر استفاده کند. هنگامی که یک متغیر در پیام گنجانده می شود، در شی details ظاهر می شود.
instance یک رشته متنی که دارای شناسه خطا است که برای هر تماس فردی منحصر به فرد است. در صورت گزارش مشکلی در سرویس، ممکن است از شما شماره نمونه را بخواهیم.
details اختیاری. شامل متغیرهایی است که در message درج می شوند. پیام ها می توانند شامل چندین متغیر باشند.

برای اطلاعات در مورد خطاهایی که به Nest API مرتبط نیستند، به سایر کدهای خطا و پیام‌ها مراجعه کنید.

مسدود

از حد مجاز فراتر رفته است.

مولفه های
کد وضعیت HTTP: 429 درخواست خیلی زیاد
error مسدود
type https://developers.nest.com/reference/error-messages#blocked
message مسدود

نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد

خاموشی اضطراری در حال اجرا است. تماس های API تا زمانی که عملکرد عادی بازیابی نشود پذیرفته نمی شود.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message نمی توان فن را در حین خاموشی ایمنی دود/هم فعال کرد

وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد

وقتی گرمای اضطراری روشن بود، محصول سعی کرد حالت دور را تغییر دهد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message وقتی گرمای اضطراری روشن است، نمی‌توان وضعیت خارج از خانه را تغییر داد

نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد

یک رویداد صرفه جویی در مصرف انرژی که توسط شریک انرژی Nest تعریف شده است در حال اجرا است. تماس‌های API تا پایان رویداد صرفه‌جویی در مصرف انرژی رد می‌شوند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message نمی توان حالت HVAC را در طول رویدادهای صرفه جویی در انرژی تغییر داد

نمی توان حالت HVAC را تغییر داد

حالت با درخواست ناسازگار است.

برای مثال، ممکن است این پیام را دریافت کنید اگر:

  • سیستم تهویه مطبوع ترموستات از حالت درخواستی محصول شما پشتیبانی نمی کند: heat ، cool ، heat-cool ، یا eco
  • حالت HVAC روی eco تنظیم شده است و محصول سعی می کند target_temperature را تنظیم کند
مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان حالت HVAC را به $mode تغییر داد. HVAC نمی‌تواند $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message نمی توان حالت HVAC را به $mode تغییر داد. HVAC نمی‌تواند $action
details $mode
$action

وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد

قبل از اینکه محصولی بتواند داده بنویسد، کاربر باید قفل ترموستات را باز کند .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد
type https://developers.nest.com/reference/error-messages#lock-enabled
message وقتی قفل ترموستات فعال است، نمی توان حالت HVAC را تغییر داد

نمی توان دمای C و F را به طور همزمان تنظیم کرد

این محصول سعی کرد دمای هدف را به صورت همزمان درجه سانتیگراد و فارنهایت تنظیم کند. یک محصول باید فقط دمای مورد نظر تعیین شده توسط temperature_scale حرارت_مقیاس (C/F) را تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای C و F را به طور همزمان تنظیم کرد
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message نمی توان دمای C و F را به طور همزمان تنظیم کرد

به دلیل حالت ناسازگار، نمی توان fan_timer_active را روشن/خاموش کرد

فن سیستم تهویه مطبوع از قبل فعال شده است (به صورت دستی توسط کاربر، یا بر اساس یک برنامه، یا به دلیل چرخه گرما/خنک کردن HVAC).

اگر نتیجه مورد انتظار را دریافت نکردید، به احتمال زیاد به این دلیل است که دستگاه دارای یک رفتار داخلی است که ما نمی توانیم از طریق API آن را لغو کنیم.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان fan_timer_active را روشن/خاموش کرد زیرا حالت $mode mode ناسازگار است
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message نمی توان fan_timer_active را روشن/خاموش کرد زیرا حالت $mode mode ناسازگار است
details $mode

نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد

محصول سعی کرد fan_timer_duration را روی یک مقدار نامعتبر تنظیم کند. برای لیستی از مقادیر معتبر به fan_timer_duration مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد. برای مقادیر مجاز به مرجع API مراجعه کنید.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message نمی توان fan_timer_duration را روی مقدار انتخابی تنظیم کرد. برای مقادیر مجاز به مرجع API مراجعه کنید.

نمی توان دمای پایین هدف را بالاتر از دمای بالای هدف قرار داد

ترموستات در حالت heat-cool است، و محصول سعی کرد دمای هدف را کم/بالا تنظیم کند که خارج از محدوده باشد. به عنوان مثال، محصول سعی کرد target_temperature_low_c را روی 25 درجه سانتیگراد تنظیم کند، زمانی که target_temperature_high_c 24 درجه سانتیگراد است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای پایین $lowTemp بالاتر از دمای بالای هدف $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message نمی توان دمای پایین $lowTemp بالاتر از دمای بالای هدف $highTemp
details $lowTemp
$highTemp

نمی توان دمای هدف را نزدیک تر از N درجه سانتی گراد تنظیم کرد

محصول سعی کرد یک مقدار دمای هدف را خیلی نزدیک به دمای بالا/پایین هدف تنظیم کند (به عنوان مثال، target_temperature_high_f ).

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان دمای هدف را نزدیک تر از N درجه سانتی گراد تنظیم کرد
type https://developers.nest.com/reference/error-messages#range-error
message نمی توان دمای هدف را نزدیکتر از $min درجه $scale تنظیم کرد
details $min
$scale

در حالت $mode نمی توان target_temperature را تنظیم کرد

ترموستات یا ساختار در حال حاضر در حالتی است که از درخواست‌های API پشتیبانی نمی‌کند.

به عنوان مثال، نمی توانید target_temperature_f یا target_temperature_c را هنگامی که سیستم HVAC off است یا در حالت heat-cool کنید. تا زمانی که ترموستات/ساختار به حالت غیرمحدود برگردد، نمی‌توان مقدار را تغییر داد.

در این پیام، $fieldName می‌تواند هر یک از مقادیر دمای مورد نظر باشد و $mode می‌تواند یکی از موارد زیر باشد: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error در حالت $mode نمی توان target_temperature را تنظیم کرد
type https://developers.nest.com/reference/error-messages#mode-error
message نمی توان $fieldName در حالی که حالت $mode تنظیم کرد
details $fieldName
$mode

قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است

برای تنظیم دمای اکو، دستگاه باید به نسخه سفت‌افزار فعلی به‌روزرسانی شود.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است. به‌روزرسانی‌ها به‌طور خودکار انجام می‌شوند، معمولاً ظرف یک هفته پس از انتشار.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message قبل از اینکه بتوانید حالت HVAC را تغییر دهید، به‌روزرسانی میان‌افزار دستگاه مورد نیاز است. به‌روزرسانی‌ها به‌طور خودکار انجام می‌شوند، معمولاً ظرف یک هفته پس از انتشار.

خطا هنگام تأیید فیلدهای WWN

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error خطا هنگام تأیید فیلدهای WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message خطا هنگام تأیید فیلدهای WWN: $error
details $error

ایتا در گذشته است

زمان ETA مشخص شده در گذشته (قبل از NOW) است. برای اطلاعات بیشتر در مورد برقراری تماس های ETA، به راهنمای خارج از خانه و ETA مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA در گذشته است: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA در گذشته است: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA در آینده بسیار دور است

زمان ETA مشخص شده در آینده نمی تواند بیش از 8 ساعت باشد. برای اطلاعات بیشتر در مورد برقراری تماس های ETA، به راهنمای خارج از خانه و ETA مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA در آینده بسیار دور است
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA در آینده بسیار دور است

fan_timer_active تنظیم نشده است

fan_timer_active تعریف نشده است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error fan_timer_active تنظیم نشده است
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active تنظیم نشده است

ممنوع

اعتبارنامه‌هایی که برای دسترسی به سرویس Nest استفاده می‌شوند، نامعتبر هستند.

مولفه های
کد وضعیت HTTP: 403 ممنوع
error ممنوع
type https://developers.nest.com/reference/error-messages#forbidden
message ممنوع

خطای داخلی

مولفه های
کد وضعیت HTTP: 500 خطای سرور داخلی
error خطای داخلی
type https://developers.nest.com/reference/error-messages#internal-error
message خطای داخلی

شناسه دوربین نامعتبر است

camera-id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه دوربین $id نامعتبر است
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message شناسه دوربین نامعتبر: $id
details $id

محتوای نامعتبر ارسال شد

تماس حاوی محتوای نامعتبر است. به عنوان مثال، استفاده از "yes" به جای "true" برای یک متغیر بولی.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error محتوای نامعتبر ارسال شد
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message محتوای نامعتبر ارسال شد

مسیر قطعه نامعتبر است

بخشی از مسیر درخواست نامعتبر است. به عنوان مثال، نام یک شی یا فیلد ممکن است اشتباه املایی داشته باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مسیر قطعه نامعتبر: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message مسیر قطعه نامعتبر: $requestPath
details $requestPath

حالت HVAC نامعتبر است

سیستم تهویه مطبوع ترموستات از حالت درخواستی محصول پشتیبانی نمی کند: heat ، سرما، یا heat-cool cool

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حالت HVAC نامعتبر: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message حالت HVAC نامعتبر: $mode
details $mode

شناسه هشدار دود + co نامعتبر است

smoke_co_alarm_id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه زنگ دود + co نامعتبر $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message شناسه هشدار smoke+co نامعتبر است: $id
details $id

شناسه ساختار نامعتبر است

structure_id id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه ساختار نامعتبر $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message شناسه ساختار نامعتبر: $id
details $id

شناسه ترموستات نامعتبر است

thermostat_id نامعتبر است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه ترموستات $id نامعتبر است
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message شناسه ترموستات نامعتبر: $id
details $id

مقدار نامعتبر برای Away

شما سعی کردید یک مقدار نامعتبر برای away تنظیم کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error مقدار نامعتبر برای Away
type https://developers.nest.com/reference/error-messages#invalid-away-value
message مقدار نامعتبر: $value . فقط «خانه» و «خارج» مقادیر مجاز هستند.
details $value

is_streaming منطقی نیست

محصول سعی کرد فیلد is-streaming را روی یک غیر بولی تنظیم کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error is_streaming منطقی نیست
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming منطقی نیست

برچسب باید کمتر از 256 کاراکتر باشد

این محصول سعی کرد یک برچسب ترموستات با بیش از 256 کاراکتر ایجاد کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error برچسب باید کمتر از نویسه $max_label_length باشد
type https://developers.nest.com/reference/error-messages#max-label-length
message برچسب باید کمتر از نویسه $max_label_length باشد
details $max_label_length

حداکثر سفارشی در جایی که تعداد بیش از آن است

محصول سعی کرد یک wheres سفارشی ایجاد کند که در آن شی فراتر از حداکثر باشد. حداکثر تعداد سفارشی که در آن اشیاء wheres هستند 32 عدد است.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حداکثر سفارشی که در آن تعداد $max_where_count بیشتر شد
type https://developers.nest.com/reference/error-messages#max-where-count
message حداکثر سفارشی که در آن تعداد $max_where_count بیشتر شد
details $max_where_count

حداکثر سفارشی در جایی که طول نام بیشتر شده است

name جایی که خیلی طولانی است. ما کمتر از 30 کاراکتر را توصیه می کنیم.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error حداکثر سفارشی که در آن طول نام از $max_custom_where_name_length بیشتر شود
type https://developers.nest.com/reference/error-messages#max-where-name-length
message حداکثر سفارشی که در آن طول نام از $max_custom_where_name_length بیشتر شود
details $max_custom_where_name_length

میدان گم شده

فراخوان یک پارامتر لازم را ندارد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error فیلد وجود ندارد: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message فیلد وجود ندارد: $fieldName
details $fieldName

شناسه کجا وجود ندارد

قالب where_id .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه کجا وجود ندارد
type https://developers.nest.com/reference/error-messages#where-id-missing
message شناسه کجا وجود ندارد

بدون فن HVAC

به نظر نمی رسد که سیستم HVAC دارای فن مستقل باشد.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error بدون فن hvac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message بدون فن hvac

بدون ترموستات آنلاین

ترموستات در حال حاضر آفلاین است. پس از فعال شدن وای فای، محصول شما باید دوباره دسترسی پیدا کند.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error بدون ترموستات آنلاین
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message بدون ترموستات آنلاین

هیچ دستگاه جفت شده ای وجود ندارد

دستگاه‌های Nest کاربر با حساب Nest کاربر جفت نشده‌اند .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error هیچ دستگاه جفت شده ای وجود ندارد
type https://developers.nest.com/reference/error-messages#no-paired-devices
message هیچ دستگاه جفت شده ای وجود ندارد

ETA معتبری برای لغو وجود ندارد

این سفر معتبر نیست و قابل لغو نیست.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error ETA معتبری برای لغو وجود ندارد
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message ETA معتبری برای لغو وجود ندارد

بدون مجوز(های) نوشتن برای فیلد(ها)

مشتری مجوز نوشتن برای این داده ها را ندارد. برای اطلاعات بیشتر، به نمای کلی مجوزها مراجعه کنید.

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error No write permission(s) for field(s): $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message No write permission(s) for field(s): $fields
details $fields

Not a valid request type

The request type is not valid. For example, a POST call was made when a PUT is required.

Parameters
HTTP Status Code: 400 Bad Request
error Not a valid request type: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message Not a valid request type: $requestType
details $requestType

Not found

The call attempted to read a path that doesn't exist.

Parameters
HTTP Status Code: 404 Not Found
error Not found
type https://developers.nest.com/reference/error-messages#not-found
message Not found

Not in Away mode

The structure is not in Away mode when an ETA call is made. ETA calls are only accepted when the structure is set to Away.

Parameters
HTTP Status Code: 400 Bad Request
error Not in Away mode
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Not in Away mode

Not writable

The field you're attempting to write to is read-only.

Parameters
HTTP Status Code: 400 Bad Request
error Not writable
type https://developers.nest.com/reference/error-messages#not-writable
message Not writable

Only where name needs to be provided

Extra fields were included in the wheres call.

Parameters
HTTP Status Code: 400 Bad Request
error Only where name needs to be provided
type https://developers.nest.com/reference/error-messages#extra-fields
message Only where name needs to be provided

POST is not a valid request type

The request type is invalid. For example, a POST call was made when a PUT is required.

Parameters
HTTP Status Code: 400 Bad Request
error POST is not a valid request type
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST is not a valid request type

Schema violation

An occurred error when pairing devices.

Parameters
HTTP Status Code: 400 Bad Request
error Schema violation
type https://developers.nest.com/reference/error-messages#schema-violation-error
message Schema violation

Service unavailable

Parameters
HTTP Status Code: 503 Service Unavailable
error Service Unavailable
type https://developers.nest.com/reference/error-messages#service-unavailable
message Service Unavailable

Structure already has maximum number of paired devices allowed

The structure already has the maximum number of allowed devices .

Parameters
HTTP Status Code: 400 Bad Request
error Structure already has maximum number of paired devices allowed
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message Structure already has maximum number of paired devices allowed

Structure is not owned by the user

The structure_id does not match the user account of record.

Parameters
HTTP Status Code: 400 Bad Request
error Structure is not owned by the user.
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message Structure is not owned by the user.

Temperature C is too high for lock temperature

The thermostat has been locked by the user and the product attempted to set a Celsius target temperature higher than the lock temperature range.

Parameters
HTTP Status Code: 400 Bad Request
error Temperature C $tempC is too high for lock temperature $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message Temperature C $tempC is too high for lock temperature $highLockTemp
details $tempC
$highLockTemp

Temperature C is too low for lock temperature

The thermostat has been locked by the user and the product attempted to set a Celsius target temperature lower than the lock temperature range.

Parameters
HTTP Status Code: 400 Bad Request
error Temperature C $tempC is too low for lock temperature $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message Temperature C $tempC is too low for lock temperature $lowLockTemp
details $tempC
$lowLockTemp

Temperature C value is too high

The product attempted to set a target temperature value that is too high for a Celsius temperature. For allowed temperature ranges in Celsius see target_temperature_c .

Parameters
HTTP Status Code: 400 Bad Request
error Temperature C value is too high: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message Temperature C value is too high: $tempC
details $tempC

Temperature C value is too low

The product attempted to set a target temperature value that is too low for a Celsius temperature. For allowed temperature ranges in Celsius see target_temperature_c .

Parameters
HTTP Status Code: 400 Bad Request
error Temperature C value is too low: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message Temperature C value is too low: $tempC
details $tempC

Temperature F is too high for lock temperature

The thermostat has been locked by the user and the product attempted to set a Fahrenheit target temperature higher than the lock temperature range.

Parameters
HTTP Status Code: 400 Bad Request
error Temperature F $tempF is too high for lock temperature $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message Temperature F $tempF is too high for lock temperature $highLockTemp
details $tempF
$highLockTemp

Temperature F is too low for lock temperature

The thermostat has been locked by the user and the product attempted to set a Fahrenheit target temperature lower than the lock temperature range.

Parameters
HTTP Status Code: 400 Bad Request
error Temperature F $tempF is too low for lock temperature $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message Temperature F $tempF is too low for lock temperature $lowLockTemp
details $tempF
$lowLockTemp

Temperature F value is too high

The product attempted to set a target temperature value that is too high for a Fahrenheit temperature. For allowed temperature ranges in Fahrenheit see target_temperature_f .

Parameters
HTTP Status Code: 400 Bad Request
error Temperature F value is too high: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message Temperature F value is too high: $tempF
details $tempF

Temperature F value is too low

The product attempted to set a target temperature value that is too low for a Fahrenheit temperature. For allowed temperature ranges in Fahrenheit see target_temperature_f .

Parameters
HTTP Status Code: 400 Bad Request
error Temperature F value is too low: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message Temperature F value is too low: $tempF
details $tempF

Temperature is in wrong format

The product attempted to set a target temperature using the wrong number format for the chosen temperature_scale . Celsius temperatures should be integers in 0.5 degree increments (21.5), and Fahrenheit temperatures should be whole integers (72).

Parameters
HTTP Status Code: 400 Bad Request
error Temperature $temp is in wrong format
type https://developers.nest.com/reference/error-messages#format-error
message Temperature $temp is in wrong format
details $temp

The field(s) cannot be modified on update

The product attempted to write to a read-only field.

Parameters
HTTP Status Code: 400 Bad Request
error The field(s) cannot be modified on update: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message The field(s) cannot be modified on update: $fieldNames
details $fieldNames

The field(s) should use ISO 8601 format

The field is not in ISO 8601 format.

Parameters
HTTP Status Code: 400 Bad Request
error The field(s) should use ISO 8601 format: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message The field(s) should use ISO 8601 format: $fieldNames
details $fieldNames

Thermostat is not online

The thermostat is currently offline. After wi-fi is enabled, your product should regain access.

Parameters
HTTP Status Code: 400 Bad Request
error Thermostat is not online
type https://developers.nest.com/reference/error-messages#not-online
message Thermostat is not online

This trip has been manually overridden

The user has manually overridden the trip.

Parameters
HTTP Status Code: 400 Bad Request
error This trip has been manually overridden
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message This trip has been manually overridden

Unable to create where ID

The wheres object is missing. No where_id values are defined.

Parameters
HTTP Status Code: 400 Bad Request
error Unable to create where id
type https://developers.nest.com/reference/error-messages#wheres-missing
message Unable to create where id

Unauthorized

Authorization has failed.

A couple of conditions may generate this error message:

  • incorrect redirects that occur when a given HTTP implementation does not automatically forward the Authorization header to the redirected URI. For more information, see How to handle redirects .

  • incorrect permissions when trying to access API endpoints. For example, trying to read a Thermostat endpoint when only Camera permissions are selected for the client. For more information, see How to choose permissions .

Parameters
HTTP Status Code: 401 Unauthorized
error Unauthorized
type https://developers.nest.com/reference/error-messages#auth-error
message Unauthorized

Unknown

Parameters
HTTP Status Code: 400 Bad Request
error unknown
type https://developers.nest.com/reference/error-messages#unknown
message unknown

Unknown vendor/device type

Vendor/device not recognized during device pairing.

Parameters
HTTP Status Code: 400 Bad Request
error Unknown vendor/device type
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message Unknown vendor/device type

Value of $fieldName is of wrong type

The wrong data type was sent. For example, sending a string when a boolean is expected.

Parameters
HTTP Status Code: 400 Bad Request
error Value of $fieldName is of wrong type
type https://developers.nest.com/reference/error-messages#wrong-data-type
message Value of $fieldName is of wrong type
details $fieldName

Where name already exists

The where_name the product tried to set already exists. Try again with a new name.

Parameters
HTTP Status Code: 400 Bad Request
error Where name $name already exists
type https://developers.nest.com/reference/error-messages#where-name-exists
message Where name $name already exists
details $name

Where name is not provided

The where_name is missing from the call.

Parameters
HTTP Status Code: 400 Bad Request
error Where name is not provided
type https://developers.nest.com/reference/error-messages#where-name-missing
message Where name is not provided

Where name is of zero length

The where name is not defined (has zero characters).

Parameters
HTTP Status Code: 400 Bad Request
error Where name is of zero length
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message Where name is of zero length

Where name must be a string

The wrong data type was sent for the where_name . For example, a number when a string is expected.

Parameters
HTTP Status Code: 400 Bad Request
error Where name must be a string
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Where name must be a string

where_id does not exist

The where_id is invalid.

Parameters
HTTP Status Code: 400 Bad Request
error where_id does not exist
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id does not exist
details $where_id

where_id must be a string

The where_id format is invalid. For example, a number was sent instead of a string.

Parameters
HTTP Status Code: 400 Bad Request
error where_id must be a string
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id must be a string

Other error codes and messages

Device error codes

For device-specific error codes and messages unrelated to the Nest API, see the following:

REST error codes

When you make a REST API call, common HTTP status codes are returned.

REST rate limit messages

When using REST and you send too many calls in a short period of time, you may receive a HTTP response status code of 429 Too Many Requests.

For more information, see Data Rate Limits .