تُعدّ حالات الخطأ جزءًا من دورة التطوير، ويمكن أن تتراوح من أخطاء بسيطة، مثل معلمة غير صالحة أو مفقودة، إلى سيناريوهات أكثر تعقيدًا، مثل الحالة غير المتوقعة أو حتى الإعدادات المتعلقة بالجهاز، والتي يجب حلها خارج واجهة برمجة التطبيقات.
عند حدوث خطأ أثناء طلب بيانات من واجهة برمجة التطبيقات، يتم إرسال رد بهذا التنسيق:
{ "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 | محظورة |
لا يمكن تفعيل المروحة أثناء إغلاق الجهاز بسبب الدخان/أول أكسيد الكربون
إيقاف التشغيل في حالات الطوارئ ساري المفعول. لا يتم قبول طلبات البيانات من واجهة برمجة التطبيقات حتى تتم استعادة التشغيل العادي.
المعلَمات | |
---|---|
رمز حالة 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 | لا يمكن تغيير حالة "خارج المنزل" أثناء تفعيل التدفئة في حالات الطوارئ. |
لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة.
هناك فعالية مخصّصة لتوفير الطاقة يحدّدها أحد شركاء Nest للطاقة. يتم رفض طلبات البيانات من واجهة برمجة التطبيقات حتى انتهاء فعالية توفير الطاقة.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة. |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء فعاليات توفير الطاقة. |
يتعذّر تغيير وضع التدفئة والتهوية وتكييف الهواء.
الوضع غير متوافق مع الطلب.
على سبيل المثال، قد تتلقى هذه الرسالة في الحالات التالية:
- نظام التدفئة والتهوية وتكييف الهواء غير متاح في الوضع الذي طلبه منتجك:
heat
أوcool
أوheat-cool
أوeco
. - تم ضبط وضع التدفئة والتهوية وتكييف الهواء على
eco
ويحاول المنتج ضبطtarget_temperature
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء إلى "$mode "، لأنّ التدفئة والتهوية وتكييف الهواء غير متاحة.$action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء إلى "$mode "، لأنّ التدفئة والتهوية وتكييف الهواء غير متاحة.$action |
details | $mode |
لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات.
ويجب على المستخدم تفعيل الترموستات قبل أن يتمكن المنتج من كتابة البيانات.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات. |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | لا يمكن تغيير وضع التدفئة والتهوية وتكييف الهواء أثناء تفعيل قفل الترموستات. |
لا يمكن ضبط درجات الحرارة 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 في آنٍ واحد. |
لا يمكن ضبط/إيقاف المعجبين_على وقت_تفعيل الحساب بسبب الوضع غير المتوافق.
تعمل مروحة التدفئة والتهوية وتكييف الهواء حاليًا (إما من خلال المستخدم يدويًا، أو وفقًا لجدول زمني، أو بسبب دورة التدفئة/التبريد).
وإذا لم تحصل على النتيجة المتوقعة، يُرجح أن يكون السبب حدوث سلوك مضمَّن في الجهاز لا يمكننا تجاوزه من خلال واجهة برمجة التطبيقات.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | لا يمكن ضبط/إيقاف المعجبين_بوقت_نشط بسبب الوضع غير المتوافق $mode |
type | https://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 على القيمة المحددة. يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات للقيم المسموح بها. |
type | https://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 . |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | لا يمكن ضبط درجة حرارة منخفضة المستهدفة على $lowTemp أعلى من درجة الحرارة المرتفعة $highTemp . |
details | $lowTemp |
لا يمكن ضبط درجة حرارة مستهدفة أقرب من 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 |
لا يمكن ضبط 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 |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | لا يمكن ضبط $fieldName عندما يكون الوضع $mode |
details | $fieldName |
يجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء.
يجب تحديث الجهاز إلى الإصدار الحالي للبرامج الثابتة لضبط ميزة "درجات حرارة اقتصادية".
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | يجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء. تكون التحديثات تلقائية في غضون أسبوع من إصدارها. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | يجب تحديث البرامج الثابتة على الجهاز قبل تغيير وضع التدفئة والتهوية وتكييف الهواء. تكون التحديثات تلقائية في غضون أسبوع من إصدارها. |
حدث خطأ أثناء التحقق من صحة حقول WWN
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | حدث خطأ أثناء التحقق من صحة حقول WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | حدث خطأ أثناء التحقق من صحة حقول WWN: $error |
details | $error |
الوقت المقدر للوصول هو من الماضي
التاريخ المقدر للوصول هو من الماضي (قبل NOW). وللحصول على مزيد من المعلومات حول إجراء مكالمات الوقت المقدر للوصول، راجِع دليل Away & 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 |
الوقت المقدر للوصول بعيد جدًا في المستقبل
لا يمكن أن يتجاوز الوقت المقدر للوصول 8 ساعات في المستقبل. وللحصول على مزيد من المعلومات حول إجراء مكالمات الوقت المقدر للوصول، راجع دليل الوصول إلى البريد الإلكتروني &والوصول التلقائي.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | الوقت المقدر للوصول بعيد جدًا في المستقبل |
type | https://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 |
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 |
وضع التدفئة والتهوية وتكييف الهواء غير صالح.
نظام التدفئة والتهوية وتكييف الهواء غير متاح في الوضع الذي طلبه المنتج:
heat
أو cool
أو heat-cool
.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | وضع التدفئة والتهوية وتكييف الهواء غير صالح: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | وضع التدفئة والتهوية وتكييف الهواء غير صالح: $mode |
details | $mode |
رقم تعريف منبّه الدخان+co غير صالح.
قيمة smoke_co_alarm_id
غير صالحة.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | رقم تعريف منبّه الدخان+co غير صالح $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 يُسمح فقط بالقيم 'home' و 'away'. |
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 | معرف المكان مفقود |
لا تتوفر مروحة تدفئة وتهوية وتكييف هواء
يَبْدُو أَنَّ نِظَامَ التَّدْفِئَة الْهَوَاءْ غَيْرْ مُتَوَفِّرْ.
المعلَمات | |
---|---|
رمز حالة 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 إلا عندما يتم ضبط البنية على "خارج المنزل".
المعلَمات | |
---|---|
رمز حالة 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 |
قيمة درجة الحرارة F منخفضة جدًا
حاول المنتج ضبط قيمة درجة حرارة مستهدفة منخفضة جدًا بحيث لا تصل إلى درجة حرارة فهرنهايت. للتعرّف على نطاقات درجات الحرارة المسموح بها بالفهرنهايت، يُرجى الاطّلاع على
target_temperature_f
.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | قيمة درجة الحرارة F منخفضة جدًا: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | قيمة درجة الحرارة F منخفضة جدًا: $tempF |
details | $tempF |
درجة الحرارة بتنسيق غير صحيح
حاول المنتج ضبط درجة حرارة مستهدَفة باستخدام صيغة رقم غير صحيحة في temperature_scale
المُختارة. ويجب أن تكون درجات الحرارة المئوية أعدادًا صحيحة بزيادات بمقدار 0.5 درجة (21.5)، بينما يجب أن تكون درجات الحرارة فهرنهايت أعدادًا صحيحة كاملة (72).
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | درجة الحرارة $temp بتنسيق غير صحيح |
type | https://developers.nest.com/reference/error-messages#format-error |
message | درجة الحرارة $temp بتنسيق غير صحيح |
details | $temp |
لا يمكن تعديل الحقول عند التحديث.
حاول المنتج الكتابة في حقل للقراءة فقط.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | لا يمكن تعديل الحقول عند التحديث: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | لا يمكن تعديل الحقول عند التحديث: $fieldNames |
details | $fieldNames |
يجب أن تستخدم الحقول تنسيق ISO 8601
الحقل ليس بتنسيق ISO 8601.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | يجب أن تستخدم الحقول الحقول ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | يجب أن تستخدم الحقول الحقول ISO 8601: $fieldNames |
details | $fieldNames |
الترموستات غير متصل بالإنترنت.
الترموستات حاليًا غير متصل بالإنترنت. بعد تفعيل wi-fi، من المفترض أن يحصل منتجك على إمكانية الوصول مرة أخرى.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | الترموستات غير متصل بالإنترنت. |
type | https://developers.nest.com/reference/error-messages#not-online |
message | الترموستات غير متصل بالإنترنت. |
تم إلغاء هذه الرحلة يدويًا.
تجاوز المستخدم الرحلة يدويًا.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | تم إلغاء هذه الرحلة يدويًا. |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | تم إلغاء هذه الرحلة يدويًا. |
تعذّر إنشاء رقم التعريف.
الكائن wheres
مفقود. لم يتم تحديد أي قيم للسمة where_id
.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | تعذّر إنشاء مكان رقم التعريف |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | تعذّر إنشاء مكان رقم التعريف |
غير مخول
تعذّر التفويض.
في بعض الحالات، قد تظهر رسالة الخطأ هذه:
عمليات إعادة توجيه غير صحيحة تحدث عندما لا يعيد تنفيذ HTTP معين توجيه عنوان التفويض تلقائيًا إلى معرف الموارد المنتظم (URI) الذي تمت إعادة توجيهه. للحصول على المزيد من المعلومات، يُرجى الاطّلاع على كيفية التعامل مع عمليات إعادة التوجيه.
الأذونات غير الصحيحة عند محاولة الوصول إلى نقاط نهاية واجهة برمجة التطبيقات. على سبيل المثال، محاولة قراءة نقطة نهاية الترموستات عند اختيار أذونات الكاميرا فقط للعميل. لمزيد من المعلومات، يُرجى الاطِّلاع على كيفية اختيار الأذونات.
المعلَمات | |
---|---|
رمز حالة 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 |
يجب أن يكون حيث_id سلسلة
التنسيق where_id
غير صالح. على سبيل المثال، تم إرسال رقم بدلاً من سلسلة.
المعلَمات | |
---|---|
رمز حالة HTTP: 400 طلب غير صالح | |
error | يجب أن يكون حيث_id سلسلة |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | يجب أن يكون حيث_id سلسلة |
رموز الخطأ والرسائل الأخرى
رموز أخطاء الجهاز
وبالنسبة إلى رموز الخطأ الخاصة بالجهاز والرسائل غير المرتبطة بواجهة برمجة تطبيقات Nest، يُرجى الاطّلاع على ما يلي:
رموز خطأ REST
عند إجراء طلب بيانات من REST API، يتم عرض رموز حالة HTTP الشائعة.
رسائل حدود نسبة REST
عند استخدام REST وإرسال عدد كبير جدًا من المكالمات في فترة زمنية قصيرة، قد تتلقى رمز حالة استجابة HTTP من 429 عدد كبير جدًا من الطلبات.
لمزيد من المعلومات، اطّلع على حدود معدل بيانات.