پیغام خطا

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

برای کسب اطلاعات در خطا به 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 را در طول رویدادهای صرفه جویی در انرژی تغییر داد

رویداد صرفه جویی در انرژی تعریف شده توسط یک شریک انرژی آشیانه در اثر است. تماس‌های 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 می توانید حالت های تهویه مطبوع به تغییر نیست $mode ؛ HVAC نمی تواند $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message می توانید حالت های تهویه مطبوع به تغییر نیست $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
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message به علت وجود حالت ناسازگار مجموعه fan_timer_active روشن / خاموش $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 که سیستم تهویه مطبوع است 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 مشخص شده در گذشته (قبل از NOW) است. برای کسب اطلاعات بیشتر در برقراری تماس ETA، را ببینید دور و راهنمای ETA .

مولفه های
HTTP وضعیت کد: 400 درخواست بد
error زمان رسیدن به مقصد در گذشته است: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message زمان رسیدن به مقصد در گذشته است: $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 ، 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
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message نامعتبر دود + شرکت زنگ ID: $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

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

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

دستگاه های آشیانه کاربر در حال با حساب آشیانه کاربر زوج .

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

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