رسائل الخطأ

تُعدّ حالات الخطأ جزءًا من دورة التطوير، ويمكن أن تتراوح من أخطاء بسيطة، مثل معلمة غير صالحة أو مفقودة، إلى سيناريوهات أكثر تعقيدًا، مثل الحالة غير المتوقعة أو حتى الإعدادات المتعلقة بالجهاز، والتي يجب حلها خارج واجهة برمجة التطبيقات.

عند حدوث خطأ أثناء طلب بيانات من واجهة برمجة التطبيقات، يتم إرسال رد بهذا التنسيق:

{
  "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، يُرجى الاطّلاع على رموز الخطأ والرسائل الأخرى.

محظورة

تم تجاوز حد المعدل.

المعلَمات
رمز حالة HTTP: 429 عدد كبير جدًا من الطلبات
errorمحظورة
typehttps://developers.nest.com/reference/error-messages#blocked
messageمحظورة

لا يمكن تفعيل المروحة أثناء إغلاق الجهاز بسبب الدخان/أول أكسيد الكربون

إيقاف التشغيل في حالات الطوارئ ساري المفعول. لا يتم قبول طلبات البيانات من واجهة برمجة التطبيقات حتى تتم استعادة التشغيل العادي.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تفعيل المروحة أثناء إغلاق الجهاز بسبب الدخان/أول أكسيد الكربون
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageلا يمكن تفعيل المروحة أثناء إغلاق الجهاز بسبب الدخان/أول أكسيد الكربون

لا يمكن تغيير حالة "خارج المنزل" أثناء تفعيل التدفئة في حالات الطوارئ.

حاول المنتج تغيير حالة "خارج المنزل" أثناء تفعيل طوارئ الطوارئ.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تغيير حالة "خارج المنزل" أثناء تفعيل التدفئة في حالات الطوارئ.
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageلا يمكن تغيير حالة "خارج المنزل" أثناء تفعيل التدفئة في حالات الطوارئ.

لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة.

هناك فعالية مخصّصة لتوفير الطاقة يحدّدها أحد شركاء Nest للطاقة. يتم رفض طلبات البيانات من واجهة برمجة التطبيقات حتى انتهاء فعالية توفير الطاقة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة.
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة.

يتعذّر تغيير وضع التدفئة والتهوية وتكييف الهواء.

الوضع غير متوافق مع الطلب.

على سبيل المثال، قد تتلقى هذه الرسالة في الحالات التالية:

  • نظام التدفئة والتهوية وتكييف الهواء غير متاح في الوضع الذي طلبه منتجك: heat أو cool أو heat-cool أو eco.
  • تم ضبط وضع التدفئة والتهوية وتكييف الهواء على eco ويحاول المنتج ضبط target_temperature
المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء إلى "$mode"، لأنّ التدفئة والتهوية وتكييف الهواء غير متاحة.$action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء إلى "$mode"، لأنّ التدفئة والتهوية وتكييف الهواء غير متاحة.$action
details$mode
$action

لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات.

ويجب على المستخدم تفعيل الترموستات قبل أن يتمكن المنتج من كتابة البيانات.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات.
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageلا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات.

لا يمكن ضبط درجات الحرارة C وF في آنٍ واحد.

حاول المنتج ضبط كل من درجات الحرارة المستهدفة المئوية والفهرنهايت في الوقت نفسه. يجب أن يحدّد المنتج درجة الحرارة المستهدَفة التي تحدّدها العلامة temperature_scale (C/F) فقط.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن ضبط درجات الحرارة C وF في آنٍ واحد.
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageلا يمكن ضبط درجات الحرارة C وF في آنٍ واحد.

لا يمكن ضبط/إيقاف المعجبين_على وقت_تفعيل الحساب بسبب الوضع غير المتوافق.

تعمل مروحة التدفئة والتهوية وتكييف الهواء حاليًا (إما من خلال المستخدم يدويًا، أو وفقًا لجدول زمني، أو بسبب دورة التدفئة/التبريد).

وإذا لم تحصل على النتيجة المتوقعة، يُرجح أن يكون السبب حدوث سلوك مضمَّن في الجهاز لا يمكننا تجاوزه من خلال واجهة برمجة التطبيقات.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن ضبط/إيقاف المعجبين_بوقت_نشط بسبب الوضع غير المتوافق $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageلا يمكن ضبط/إيقاف المعجبين_بوقت_نشط بسبب الوضع غير المتوافق $mode
details$mode

لا يمكن ضبط Fan_timer_duration على القيمة المحددة

حاول المنتج ضبط fan_timer_duration على قيمة غير صالحة. يُرجى الاطّلاع على fan_timer_duration للحصول على قائمة بالقيم الصالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن ضبط Fan_timer_duration على القيمة المحددة. يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات للقيم المسموح بها.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageلا يمكن ضبط Fan_timer_duration على القيمة المحددة. يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات للقيم المسموح بها.

يتعذّر ضبط درجة حرارة مستهدفة منخفضة أعلى من درجة الحرارة المرتفعة المستهدفة

الترموستات في وضع heat-cool، وحاول المنتج ضبط درجة حرارة مستهدفة/منخفضة خارج النطاق. على سبيل المثال، حاول المنتج ضبط target_temperature_low_c على 25 درجة مئوية عندما يكون target_temperature_high_c 24 درجة مئوية.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن ضبط درجة حرارة منخفضة المستهدفة على $lowTemp أعلى من درجة الحرارة المرتفعة $highTemp.
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageلا يمكن ضبط درجة حرارة منخفضة المستهدفة على $lowTemp أعلى من درجة الحرارة المرتفعة $highTemp.
details$lowTemp
$highTemp

لا يمكن ضبط درجة حرارة مستهدفة أقرب من N درجة مئوية/مئوية

حاول المنتج ضبط قيمة درجة الحرارة المستهدَفة قريبة جدًا من درجة الحرارة المستهدَفة المرتفعة أو المنخفضة (مثل target_temperature_high_f).

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن ضبط درجة حرارة مستهدفة أقرب من N درجة مئوية/مئوية
typehttps://developers.nest.com/reference/error-messages#range-error
messageلا يمكن ضبط درجة الحرارة المستهدفة لتكون أقرب من $min درجة $scale.
details$min
$scale

لا يمكن ضبط target_درجة الحرارة عندما يكون الوضع هو $mode

الترموستات أو البنية في وضع غير متوافق حاليًا مع طلبات البيانات من واجهة برمجة التطبيقات.

على سبيل المثال، لا يمكنك ضبط 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_° حين يكون الوضع $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageلا يمكن ضبط $fieldName عندما يكون الوضع $mode
details$fieldName
$mode

يجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء.

يجب تحديث الجهاز إلى الإصدار الحالي للبرامج الثابتة لضبط ميزة "درجات حرارة اقتصادية".

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء. تكون التحديثات تلقائية في غضون أسبوع من إصدارها.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageيجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء. تكون التحديثات تلقائية في غضون أسبوع من إصدارها.

حدث خطأ أثناء التحقق من صحة حقول WWN

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorحدث خطأ أثناء التحقق من صحة حقول WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageحدث خطأ أثناء التحقق من صحة حقول WWN: $error
details$error

الوقت المقدر للوصول هو من الماضي

التاريخ المقدر للوصول هو من الماضي (قبل NOW). وللحصول على مزيد من المعلومات حول إجراء مكالمات الوقت المقدر للوصول، راجِع دليل Away & ETA.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorالوقت المقدر للوصول هو في الماضي: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageالوقت المقدر للوصول هو في الماضي: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

الوقت المقدر للوصول بعيد جدًا في المستقبل

لا يمكن أن يتجاوز الوقت المقدر للوصول 8 ساعات في المستقبل. وللحصول على مزيد من المعلومات حول إجراء مكالمات الوقت المقدر للوصول، راجع دليل الوصول إلى البريد الإلكتروني &والوصول التلقائي.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorالوقت المقدر للوصول بعيد جدًا في المستقبل
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageالوقت المقدر للوصول بعيد جدًا في المستقبل

لم يتم ضبط Fan_timer_active

لم يتم تحديد fan_timer_active.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلم يتم ضبط Fan_timer_active
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageلم يتم ضبط Fan_timer_active

محظور

بيانات الاعتماد المستخدمة للوصول إلى خدمة Nest غير صالحة.

المعلَمات
رمز حالة HTTP: 403 محظور
errorمحظور
typehttps://developers.nest.com/reference/error-messages#forbidden
messageمحظور

خطأ داخلي

المعلَمات
رمز حالة HTTP: خطأ 500 في الخادم الداخلي
errorخطأ داخلي
typehttps://developers.nest.com/reference/error-messages#internal-error
messageخطأ داخلي

معرّف الكاميرا غير صالح.

قيمة camera-id غير صالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorرقم تعريف الكاميرا $id غير صالح.
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageمعرّف الكاميرا غير صالح: $id
details$id

تم إرسال محتوى غير صالح

تحتوي المكالمة على محتوى غير صالح. على سبيل المثال، يتم استخدام "yes" بدلاً من "true" لمتغير منطقي.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorتم إرسال محتوى غير صالح
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageتم إرسال محتوى غير صالح

مسار الجزء غير صالح

جزء من مسار الطلب غير صالح. على سبيل المثال، قد يكون خطأ في الكائن أو اسم الحقل.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorمسار الجزء غير صالح: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageمسار الجزء غير صالح: $requestPath
details$requestPath

وضع التدفئة والتهوية وتكييف الهواء غير صالح.

نظام التدفئة والتهوية وتكييف الهواء غير متاح في الوضع الذي طلبه المنتج: heat أو cool أو heat-cool.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorوضع التدفئة والتهوية وتكييف الهواء غير صالح: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageوضع التدفئة والتهوية وتكييف الهواء غير صالح: $mode
details$mode

رقم تعريف منبّه الدخان+co غير صالح.

قيمة smoke_co_alarm_id غير صالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorرقم تعريف منبّه الدخان+co غير صالح $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageرقم تعريف منبّه الدخان+co غير صالح: $id
details$id

رقم تعريف البنية غير صالح

قيمة structure_id غير صالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorرقم تعريف البنية $id غير صالح
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageرقم تعريف البنية غير صالح: $id
details$id

رقم تعريف الترموستات غير صالح

قيمة thermostat_id غير صالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorرقم تعريف الترموستات $id غير صالح.
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageرقم تعريف الترموستات غير صالح: $id
details$id

قيمة غير صالحة خارج المنزل

لقد حاولت ضبط قيمة غير صالحة لـ away.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorقيمة غير صالحة خارج المنزل
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageقيمة غير صالحة: $value يُسمح فقط بالقيم 'home' و 'away'.
details$value

is_streaming غير منطقي

حاول المنتج ضبط الحقل is-streaming على قيمة غير منطقية.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
erroris_streaming غير منطقي
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming غير منطقي

يجب أن يكون التصنيف أقل من 256 حرفًا.

حاول المنتج إنشاء تصنيف ترموستات يحتوي على أكثر من 256 حرفًا.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب أن يكون التصنيف أقل من $max_label_length حرف.
typehttps://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
typehttps://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
typehttps://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
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageيجب ملء الحقل: $fieldName
details$fieldName

معرّف المكان مفقود

التنسيق where_id غير متوفّر.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorمعرف المكان مفقود
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageمعرف المكان مفقود

لا تتوفر مروحة تدفئة وتهوية وتكييف هواء

يَبْدُو أَنَّ نِظَامَ التَّدْفِئَة الْهَوَاءْ غَيْرْ مُتَوَفِّرْ.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا تتوفر مروحة بنظام التدفئة والتهوية وتكييف الهواء
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageلا تتوفر مروحة بنظام التدفئة والتهوية وتكييف الهواء

ما مِن أجهزة ترموستات على الإنترنت

الترموستات حاليًا غير متصل بالإنترنت. بعد تفعيل wi-fi، من المفترض أن يحصل منتجك على إمكانية الوصول مرة أخرى.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorما مِن أجهزة ترموستات على الإنترنت
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageما مِن أجهزة ترموستات على الإنترنت

ليست هناك أجهزة تم إقرانها.

لا يتم إقران أجهزة Nest للمستخدم مع حساب Nest.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorليست هناك أجهزة تم إقرانها.
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageليست هناك أجهزة تم إقرانها.

ما مِن قيمة وصول مقدّرة صالحة للإلغاء.

الرحلة غير صالحة ولا يمكن إلغاؤها.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorما مِن قيمة وصول مقدّرة صالحة للإلغاء.
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageما مِن قيمة وصول مقدّرة صالحة للإلغاء.

لا تتوفّر أذونات للكتابة للحقول.

ليس لدى العميل إذن بالكتابة لهذه البيانات. لمزيد من المعلومات، يرجى الاطلاع على نظرة عامة على الأذونات.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorليس هناك أذونات بالكتابة للحقول: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageليس هناك أذونات بالكتابة للحقول: $fields
details$fields

نوع طلب غير صالح

نوع الطلب غير صالح. على سبيل المثال، يتم إجراء POST عند طلب PUT.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorنوع الطلب غير صالح: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageنوع الطلب غير صالح: $requestType
details$requestType

لم يتم العثور عليه

حاولت المكالمة قراءة مسار غير موجود.

المعلَمات
رمز حالة HTTP: 404 لم يتم العثور على الصفحة
errorلم يتم العثور عليه
typehttps://developers.nest.com/reference/error-messages#not-found
messageلم يتم العثور عليه

ليست في وضع "خارج المنزل"

البنية ليست في "وضع الإيقاف" عند إجراء استدعاء. لا يتم قبول استدعاءات ETA إلا عندما يتم ضبط البنية على "خارج المنزل".

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorليست في وضع "خارج المنزل"
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageليست في وضع "خارج المنزل"

غير قابل للكتابة

الحقل الذي تحاول الكتابة فيه هو للقراءة فقط.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorغير قابل للكتابة
typehttps://developers.nest.com/reference/error-messages#not-writable
messageغير قابل للكتابة

يجب تقديم الاسم فقط

تم تضمين حقول إضافية في wheres.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب تقديم الاسم فقط
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageيجب تقديم الاسم فقط

نوع الطلب POST غير صالح.

نوع الطلب غير صالح. على سبيل المثال، يتم إجراء POST عند طلب PUT.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorنوع الطلب POST غير صالح.
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messageنوع الطلب POST غير صالح.

مخالفة المخطط

حدث خطأ عند إقران الأجهزة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorمخالفة المخطط
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageمخالفة المخطط

خدمة غير متاحة

المعلَمات
رمز حالة HTTP: خدمة 503 غير متاحة
errorالخدمة غير متوفرة
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageالخدمة غير متوفرة

تتضمن البنية الحد الأقصى لعدد الأجهزة المقترنة المسموح بها

تتضمن البنية الحد الأقصى لعدد الأجهزة المسموح بها.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorتتضمن البنية الحد الأقصى لعدد الأجهزة المقترنة المسموح بها
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageتتضمن البنية الحد الأقصى لعدد الأجهزة المقترنة المسموح بها

البنية ليست مملوكة للمستخدم

لا يتطابق structure_id مع حساب المستخدم المسجّل.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorالبنية ليست مملوكة للمستخدم.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageالبنية ليست مملوكة للمستخدم.

درجة الحرارة C مرتفعة جدًا بالنسبة إلى درجة حرارة القفل

تم قفل الترموستات من قِبل المستخدم وحاول المنتج ضبط درجة حرارة مستهدفة للدرجة المئوية أعلى من نطاق درجة حرارة القفل.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorدرجة الحرارة C $tempC مرتفعة جدًا بحيث لا يمكن استخدامها في قفل درجة الحرارة $highLockTemp.
typehttps://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.
typehttps://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
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageقيمة درجة الحرارة C مرتفعة جدًا: $tempC
details$tempC

قيمة درجة الحرارة C منخفضة جدًا

حاول المنتج ضبط قيمة درجة حرارة مستهدفة منخفضة جدًا بحيث لا تصل إلى درجة مئوية. بالنسبة إلى نطاقات درجة الحرارة المسموح بها بالنسبة المئوية، يمكنك الاطّلاع على target_temperature_c.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorقيمة درجة الحرارة C منخفضة جدًا: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageقيمة درجة الحرارة C منخفضة جدًا: $tempC
details$tempC

درجة الحرارة F مرتفعة جدًا بدرجة حرارة القفل.

تم قفل الترموستات من قِبل المستخدم وحاول المنتج ضبط درجة حرارة مستهدفة للفهرنهايت أعلى من نطاق درجة حرارة القفل.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorدرجة الحرارة F $tempF مرتفعة جدًا بدرجة حرارة القفل $highLockTemp
typehttps://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
typehttps://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
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageقيمة درجة الحرارة F مرتفعة جدًا: $tempF
details$tempF

قيمة درجة الحرارة F منخفضة جدًا

حاول المنتج ضبط قيمة درجة حرارة مستهدفة منخفضة جدًا بحيث لا تصل إلى درجة حرارة فهرنهايت. للتعرّف على نطاقات درجات الحرارة المسموح بها بالفهرنهايت، يُرجى الاطّلاع على target_temperature_f.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorقيمة درجة الحرارة F منخفضة جدًا: $tempF
typehttps://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 بتنسيق غير صحيح
typehttps://developers.nest.com/reference/error-messages#format-error
messageدرجة الحرارة $temp بتنسيق غير صحيح
details$temp

لا يمكن تعديل الحقول عند التحديث.

حاول المنتج الكتابة في حقل للقراءة فقط.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorلا يمكن تعديل الحقول عند التحديث: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageلا يمكن تعديل الحقول عند التحديث: $fieldNames
details$fieldNames

يجب أن تستخدم الحقول تنسيق ISO 8601

الحقل ليس بتنسيق ISO 8601.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب أن تستخدم الحقول الحقول ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageيجب أن تستخدم الحقول الحقول ISO 8601: $fieldNames
details$fieldNames

الترموستات غير متصل بالإنترنت.

الترموستات حاليًا غير متصل بالإنترنت. بعد تفعيل wi-fi، من المفترض أن يحصل منتجك على إمكانية الوصول مرة أخرى.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorالترموستات غير متصل بالإنترنت.
typehttps://developers.nest.com/reference/error-messages#not-online
messageالترموستات غير متصل بالإنترنت.

تم إلغاء هذه الرحلة يدويًا.

تجاوز المستخدم الرحلة يدويًا.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorتم إلغاء هذه الرحلة يدويًا.
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageتم إلغاء هذه الرحلة يدويًا.

تعذّر إنشاء رقم التعريف.

الكائن wheres مفقود. لم يتم تحديد أي قيم للسمة where_id.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorتعذّر إنشاء مكان رقم التعريف
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageتعذّر إنشاء مكان رقم التعريف

غير مخول

تعذّر التفويض.

في بعض الحالات، قد تظهر رسالة الخطأ هذه:

  • عمليات إعادة توجيه غير صحيحة تحدث عندما لا يعيد تنفيذ HTTP معين توجيه عنوان التفويض تلقائيًا إلى معرف الموارد المنتظم (URI) الذي تمت إعادة توجيهه. للحصول على المزيد من المعلومات، يُرجى الاطّلاع على كيفية التعامل مع عمليات إعادة التوجيه.

  • الأذونات غير الصحيحة عند محاولة الوصول إلى نقاط نهاية واجهة برمجة التطبيقات. على سبيل المثال، محاولة قراءة نقطة نهاية الترموستات عند اختيار أذونات الكاميرا فقط للعميل. لمزيد من المعلومات، يُرجى الاطِّلاع على كيفية اختيار الأذونات.

المعلَمات
رمز حالة HTTP: 401 غير مصرّح به
errorغير مخول
typehttps://developers.nest.com/reference/error-messages#auth-error
messageغير مخول

غير معروف

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorغير معروف
typehttps://developers.nest.com/reference/error-messages#unknown
messageغير معروف

نوع جهاز/مورّد غير معروف

لم يتم التعرّف على المورّد/الجهاز أثناء إقران الجهاز.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorنوع جهاز/مورّد غير معروف
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageنوع جهاز/مورّد غير معروف

قيمة $fieldName هي من نوع خاطئ

تم إرسال نوع بيانات غير صحيح. على سبيل المثال، إرسال سلسلة عندما يكون من المنطقي.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorقيمة $fieldName من نوع غير صحيح
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageقيمة $fieldName من نوع غير صحيح
details$fieldName

في حال توفُّر الاسم حاليًا

المنتج where_name الذي حاول إعداده متوفر حاليًا. يُرجى استخدام اسم جديد.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorحيث يكون الاسم $name موجودًا من قبل
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageحيث يكون الاسم $name موجودًا من قبل
details$name

في حال عدم إدخال اسم

where_name غير موجود في المكالمة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorفي حال عدم إدخال اسم
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageفي حال عدم إدخال اسم

عندما يكون الاسم صفرًا

لا يتم تحديد الخاصية name (بدون أحرف).

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorعندما يكون الاسم صفرًا
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageعندما يكون الاسم صفرًا

يجب أن يكون الاسم سلسلة

تم إرسال نوع بيانات غير صحيح لـ where_name. على سبيل المثال، رقم عند المتوقع وجود سلسلة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب أن يكون الاسم سلسلة
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageيجب أن يكون الاسم سلسلة

المكان غير موجود

قيمة where_id غير صالحة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorالمكان غير موجود
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messageالمكان غير موجود
details$where_id

يجب أن يكون حيث_id سلسلة

التنسيق where_id غير صالح. على سبيل المثال، تم إرسال رقم بدلاً من سلسلة.

المعلَمات
رمز حالة HTTP: 400 طلب غير صالح
errorيجب أن يكون حيث_id سلسلة
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageيجب أن يكون حيث_id سلسلة

رموز الخطأ والرسائل الأخرى

رموز أخطاء الجهاز

وبالنسبة إلى رموز الخطأ الخاصة بالجهاز والرسائل غير المرتبطة بواجهة برمجة تطبيقات Nest، يُرجى الاطّلاع على ما يلي:

رموز خطأ REST

عند إجراء طلب بيانات من REST API، يتم عرض رموز حالة HTTP الشائعة.

رسائل حدود نسبة REST

عند استخدام REST وإرسال عدد كبير جدًا من المكالمات في فترة زمنية قصيرة، قد تتلقى رمز حالة استجابة HTTP من 429 عدد كبير جدًا من الطلبات.

لمزيد من المعلومات، اطّلع على حدود معدل بيانات.