تُعد حالات الخطأ جزءًا من دورة التطوير ، ويمكن أن تتراوح من أخطاء بسيطة ، مثل معلمة غير صالحة أو مفقودة ، إلى سيناريوهات أكثر تعقيدًا ، مثل حالة غير متوقعة أو حتى الإعدادات المتعلقة بالجهاز ، والتي يجب حلها خارج واجهة برمجة التطبيقات.
عند حدوث خطأ أثناء مكالمة 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 ، راجع رموز ورسائل الخطأ الأخرى .
محظور
تم تجاوز حد المعدل .
| المعلمات | |
|---|---|
| رمز حالة HTTP: 429 عدد الطلبات كبير جدًا | |
error | محظور |
type | https://developers.nest.com/reference/error-messages#blocked |
message | محظور |
لا يمكن تنشيط المروحة أثناء إغلاق أمان الدخان / الدخان
الإغلاق الطارئ ساري المفعول. لا يتم قبول مكالمات API حتى تتم استعادة العملية العادية.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يمكن تنشيط المروحة أثناء إغلاق أمان الدخان / الدخان |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | لا يمكن تنشيط المروحة أثناء إغلاق أمان الدخان / الدخان |
لا يمكن تغيير حالة بالخارج أثناء تشغيل حرارة الطوارئ
حاول المنتج تغيير حالة بالخارج أثناء تشغيل حرارة الطوارئ .
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يمكن تغيير حالة بالخارج أثناء تشغيل حرارة الطوارئ |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | لا يمكن تغيير حالة بالخارج أثناء تشغيل حرارة الطوارئ |
لا يمكن تغيير وضع HVAC أثناء أحداث توفير الطاقة
حدث موفر للطاقة تم تحديده بواسطة شريك طاقة Nest ساري المفعول. تم رفض مكالمات واجهة برمجة التطبيقات (API) حتى انتهاء حدث توفير الطاقة.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يمكن تغيير وضع HVAC أثناء أحداث توفير الطاقة |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | لا يمكن تغيير وضع HVAC أثناء أحداث توفير الطاقة |
لا يمكن تغيير وضع HVAC
الوضع غير متوافق مع الطلب.
على سبيل المثال ، قد تحصل على هذه الرسالة إذا:
- لا يدعم نظام التدفئة والتهوية وتكييف الهواء في Thermostat الوضع الذي يطلبه منتجك:
heatأوcoolأوheat-coolأوeco - تم ضبط وضع التدفئة والتهوية وتكييف الهواء (HVAC) على الوضع
ecoويحاول المنتج تعيينtarget_temperature
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يمكن تغيير وضع HVAC إلى $mode . لا يمكن للتدفئة والتهوية وتكييف الهواء $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | لا يمكن تغيير وضع HVAC إلى $mode . لا يمكن للتدفئة والتهوية وتكييف الهواء $action |
details | $mode |
لا يمكن تغيير وضع 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).
إذا لم تحصل على النتيجة المتوقعة ، فالأرجح أن الجهاز لديه سلوك مدمج لا يمكننا تجاوزه عبر واجهة برمجة التطبيقات.
| المعلمات | |
|---|---|
| رمز حالة 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 لدرجة حرارة عالية $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | لا يمكن تعيين درجة حرارة منخفضة الهدف $lowTemp أعلى من $highTemp لدرجة حرارة عالية $highTemp |
details | $lowTemp |
لا يمكن تعيين درجة حرارة الهدف أقرب من N درجة مئوية / فهرنهايت
حاول المنتج تعيين قيمة درجة حرارة مستهدفة قريبة جدًا من درجة الحرارة العالية / المنخفضة المستهدفة (على سبيل المثال ، target_temperature_high_f ).
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يمكن تعيين درجة حرارة الهدف أقرب من N درجة C / F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | لا يمكن تعيين درجة حرارة الهدف أقرب من $min درجات $scale |
details | $min $scale |
لا يمكن تعيين target_temperature بينما يكون الوضع $
الترموستات أو البنية في وضع لا يدعم طلبات واجهة برمجة التطبيقات.
على سبيل المثال ، لا يمكنك تعيين 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 |
يلزم تحديث البرامج الثابتة للجهاز قبل أن تتمكن من تغيير وضع HVAC
يجب تحديث الجهاز إلى إصدار البرنامج الثابت الحالي من أجل ضبط درجات حرارة Eco.
| المعلمات | |
|---|---|
| رمز حالة 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 ، راجع دليل 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 |
ايتا بعيدة جدا في المستقبل
لا يمكن أن يكون وقت 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" لمتغير منطقي.
| المعلمات | |
|---|---|
| رمز حالة 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 |
دخان غير صالح + معرف التنبيه المشترك
إن smoke_co_alarm_id غير صالح.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | دخان غير صالح + معرف التنبيه المشترك معرف $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | معرف إنذار الدخان + co غير صالح: $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 .
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | قيمة غير صالحة للخارج |
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 | لا يوجد مروحة التكييف |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | لا يوجد مروحة التكييف |
لا يوجد منظم حرارة على الإنترنت
الترموستات غير متصل بالإنترنت حاليًا. بعد تمكين شبكة 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 | لا توجد أجهزة مقترنة |
لا توجد إيتا صالحة للإلغاء
الرحلة غير صالحة ولا يمكن إلغاؤها.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا توجد إيتا صالحة للإلغاء |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | لا توجد إيتا صالحة للإلغاء |
لا يوجد إذن (أذونات) الكتابة للحقل (الحقول)
العميل ليس لديه إذن الكتابة لهذه البيانات. لمزيد من المعلومات ، راجع نظرة عامة على الأذونات .
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | لا يوجد إذن (أذونات) الكتابة للحقل (الحقول): $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | لا يوجد إذن (أذونات) الكتابة للحقل (الحقول): $fields |
details | $fields |
ليس نوع طلب صالح
نوع الطلب غير صالح. على سبيل المثال ، تم إجراء مكالمة POST عندما يكون PUT مطلوبًا.
| المعلمات | |
|---|---|
| رمز حالة 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. يتم قبول مكالمات 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 ليس نوع طلب صالح
نوع الطلب غير صالح. على سبيل المثال ، تم إجراء مكالمة POST عندما يكون PUT مطلوبًا.
| المعلمات | |
|---|---|
| رمز حالة 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 |
درجة الحرارة 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 |
قيمة درجة الحرارة 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 |
درجة الحرارة 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 |
قيمة درجة الحرارة 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 |
قيمة درجة الحرارة منخفضة للغاية
حاول المنتج تعيين قيمة درجة حرارة مستهدفة منخفضة جدًا لدرجة حرارة فهرنهايت. لمعرفة نطاقات درجة الحرارة المسموح بها في فهرنهايت ، انظر 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 المعاد توجيهه. لمزيد من المعلومات ، راجع كيفية معالجة عمليات إعادة التوجيه .
أذونات غير صحيحة عند محاولة الوصول إلى نقاط نهاية واجهة برمجة التطبيقات. على سبيل المثال ، محاولة قراءة نقطة نهاية Thermostat عند تحديد أذونات الكاميرا فقط للعميل. لمزيد من المعلومات ، راجع كيفية اختيار الأذونات .
| المعلمات | |
|---|---|
| كود حالة 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 غير صالح.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | حيث لا يوجد معرف |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | حيث لا يوجد معرف |
details | $where_id |
حيث يجب أن تكون قيمة string_id
تنسيق where_id غير صالح. على سبيل المثال ، تم إرسال رقم بدلاً من سلسلة.
| المعلمات | |
|---|---|
| رمز حالة HTTP: 400 طلب غير صحيح | |
error | حيث يجب أن تكون قيمة string_id |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | حيث يجب أن تكون قيمة string_id |
رموز ورسائل الخطأ الأخرى
رموز خطأ الجهاز
بالنسبة إلى رموز الخطأ والرسائل الخاصة بالجهاز غير المتعلقة بواجهة برمجة تطبيقات Nest ، راجع ما يلي:
رموز خطأ REST
عند إجراء مكالمة REST API ، يتم إرجاع رموز حالة HTTP الشائعة.
رسائل حد معدل REST
عند استخدام REST وإرسال العديد من المكالمات في فترة زمنية قصيرة ، قد تتلقى رمز حالة استجابة HTTP من 429 عددًا كبيرًا جدًا من الطلبات.
لمزيد من المعلومات ، راجع حدود معدل البيانات .