Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

پیغام خطا

شرایط خطا بخشی از چرخه توسعه است و می تواند از خطاهای ساده مانند یک پارامتر نامعتبر یا مفقود شده تا سناریوهای پیچیده تر مانند حالت غیر منتظره یا حتی تنظیمات مربوط به دستگاه باشد که باید خارج از 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 مسدود

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

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

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

در حین روشن بودن گرمای اضطراری نمی توانید حالت Away را تغییر دهید

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

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

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

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

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

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

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

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

  • سیستم HVAC ترموستات از حالت درخواست شده توسط محصول شما پشتیبانی نمی کند: heat ، cool ، cool heat-cool یا eco
  • حالت HVAC روی eco تنظیم شده و محصول سعی می کند target_temperature تنظیم 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 قبلاً درگیر شده است (یا به صورت دستی توسط کاربر ، یا بر اساس یک برنامه ، یا به دلیل چرخه گرم / خنک کننده HVAC).

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

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error به دلیل حالت ناسازگار حالت $mode نمی توان fan_timer_active را روشن / خاموش کرد
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message به دلیل حالت ناسازگار حالت $mode نمی توان fan_timer_active را روشن / خاموش کرد
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 ، target_temperature_high_c که 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 درجه سانتیگراد / F تنظیم کرد

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

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

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

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

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

در این پیام، $fieldName می تواند هر یک از مقادیر دمای هدف و $mode می تواند از نوع: eco ، emer_heat_enable ، heat-cool ، heat ، cool ، off ، hvac_safety_shutoff_active .

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error نمی توان target_temperature را تنظیم کرد در حالی که حالت حالت $mode
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 در گذشته است

زمان ETA مشخص شده در گذشته است (قبل از NOW). برای کسب اطلاعات بیشتر در مورد برقراری تماس های ETA ، به راهنمای Away & 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 ، به راهنمای Away & 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

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

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

مولفه های
کد وضعیت 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 نامعتبر است

سیستم HVAC ترموستات از حالت درخواست شده توسط محصول پشتیبانی نمی کند: heat ، cool یا heat-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 دود نامعتبر + شناسه هشدار همکاری ID $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message دود نامعتبر + شناسه هشدار همکاری: $id
details $id

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

structure_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 دارای یک فن مستقل باشد.

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

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

ترموستات در حال حاضر آفلاین است. پس از فعال کردن Wi-Fi ، محصول شما باید مجدداً دسترسی پیدا کند.

مولفه های
کد وضعیت 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 Field ها
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 با حساب کاربری رکورد مطابقت ندارد.

مولفه های
کد وضعیت 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

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

ترموستات در حال حاضر آفلاین است. پس از فعال کردن Wi-Fi ، محصول شما باید مجدداً دسترسی پیدا کند.

مولفه های
کد وضعیت 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 درخواست بیش از حد دریافت کنید.

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