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 مسدود

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

اورژانس شاتوف در کار است. تماس های API تا زمانی که عملیات عادی بازگردد پذیرفته نمی شوند.

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

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

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

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

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

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

  • سیستم HVAC ترموستات از حالت درخواست شده توسط محصول شما پشتیبانی نمی کند: heat ، 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 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 نمی توان دمای هدف را نزدیک تر از $scale $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 در گذشته (قبل از شروع) است. برای اطلاعات بیشتر در مورد برقراری تماس 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

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

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

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

شناسه زنگ دزد نامعتبر است

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

مولفه های
کد وضعیت HTTP: 400 درخواست بد
error شناسه دزد غیر معتبر + شناسه هشدار $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 Missing Where Id
type https://developers.nest.com/reference/error-messages#where-id-missing
message Missing Where Id

بدون فن HVAC

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

مولفه های
کد وضعیت 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 انتخابی ، سعی در تنظیم دمای هدف داشت. درجه حرارت سانتیگراد باید در 5/0 درجه درجه سانتیگراد (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 نوع فروشنده یا دستگاه ناشناس

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

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

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

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

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

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

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

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

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

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

کدهای خطا REST

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

پیام های حد مجاز REST

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

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