Notice: We're retiring Works with Nest. See the home page for more information.
Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Pesan Kesalahan

Kondisi kesalahan adalah bagian dari siklus pengembangan, dan dapat berkisar dari kesalahan sederhana, seperti parameter yang tidak valid atau hilang, hingga skenario yang lebih kompleks, seperti keadaan tidak terduga atau bahkan pengaturan terkait perangkat, yang harus diselesaikan di luar API.

Ketika kesalahan terjadi selama panggilan API, tanggapan dalam format ini dikirim:

{
  "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"
  }
}

Semua pesan kesalahan berisi bidang error , type , message , dan instance . Objek details adalah opsional.

Bidang Deskripsi
error Format pesan kesalahan singkat.
type Memberikan URL ke informasi mendetail tentang kondisi kesalahan (halaman ini).
message Format pesan kesalahan panjang yang mungkin menggunakan variabel untuk memberikan detail tambahan. Ketika sebuah variabel disertakan dalam pesan, itu akan muncul di objek details .
instance String teks yang menyimpan pengenal kesalahan yang unik untuk setiap panggilan individu. Kami mungkin meminta nomor contoh jika Anda melaporkan masalah dengan layanan.
details Pilihan. Berisi variabel yang disisipkan ke dalam message . Pesan dapat berisi banyak variabel.

Untuk informasi tentang error yang tidak terkait dengan Nest API, lihat Kode dan pesan error lainnya .

Diblokir

Batas tarif telah terlampaui.

Parameter
Kode Status HTTP: 429 Permintaan Terlalu Banyak
error Diblokir
type https://developers.nest.com/reference/error-messages#blocked
message Diblokir

Tidak dapat mengaktifkan kipas selama penghentian keamanan asap / co

Pematian Darurat sedang diberlakukan. Panggilan API tidak diterima hingga operasi normal pulih.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengaktifkan kipas selama penghentian keamanan asap / co
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message Tidak dapat mengaktifkan kipas selama penghentian keamanan asap / co

Tidak dapat mengubah status Jauh saat pemanas darurat aktif

Produk mencoba mengubah status Jauh saat Pemanas Darurat aktif.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengubah status Jauh saat pemanas darurat aktif
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message Tidak dapat mengubah status Jauh saat pemanas darurat aktif

Tidak dapat mengubah mode HVAC selama acara hemat energi

Acara hemat energi yang ditentukan oleh mitra energi Nest sedang diberlakukan. Panggilan API ditolak sampai acara hemat energi berakhir.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengubah mode HVAC selama acara hemat energi
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message Tidak dapat mengubah mode HVAC selama acara hemat energi

Tidak dapat mengubah mode HVAC

Mode ini tidak sesuai dengan permintaan.

Misalnya, Anda mungkin mendapatkan pesan ini jika:

  • Sistem HVAC Thermostat tidak mendukung mode yang diminta oleh produk Anda: heat , cool , heat-cool , atau eco
  • Mode HVAC disetel ke eco dan produk mencoba menyetel target_temperature
Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengubah mode HVAC ke $mode ; HVAC tidak bisa $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message Tidak dapat mengubah mode HVAC ke $mode ; HVAC tidak bisa $action
details $mode
$action

Tidak dapat mengubah mode HVAC saat kunci termostat diaktifkan

Pengguna harus membuka kunci termostat sebelum produk dapat menulis data.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengubah mode HVAC saat kunci termostat diaktifkan
type https://developers.nest.com/reference/error-messages#lock-enabled
message Tidak dapat mengubah mode HVAC saat kunci termostat diaktifkan

Tidak dapat mengatur suhu C dan F secara bersamaan

Produk mencoba menyetel suhu target Celsius dan Fahrenheit secara bersamaan. Sebuah produk harus menetapkan hanya suhu target yang ditentukan oleh temperature_scale (C / F).

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengatur suhu C dan F secara bersamaan
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message Tidak dapat mengatur suhu C dan F secara bersamaan

Tidak dapat mengaktifkan / menonaktifkan fan_timer_active karena mode tidak kompatibel

Kipas sistem HVAC sudah diaktifkan (baik secara manual oleh pengguna, atau sesuai jadwal, atau karena siklus panas / dingin HVAC).

Jika Anda tidak mendapatkan hasil yang diharapkan, kemungkinan besar karena perangkat memiliki perilaku bawaan yang tidak dapat kita ganti melalui API.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat mengaktifkan / menonaktifkan fan_timer_active karena mode $mode mode tidak kompatibel
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message Tidak dapat mengaktifkan / menonaktifkan fan_timer_active karena mode $mode mode tidak kompatibel
details $mode

Tidak dapat menyetel fan_timer_duration ke nilai yang dipilih

Produk mencoba menyetel fan_timer_duration ke nilai yang tidak valid. Lihat fan_timer_duration untuk daftar nilai yang valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat menyetel fan_timer_duration ke nilai yang dipilih. Lihat referensi API untuk nilai yang diizinkan.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message Tidak dapat menyetel fan_timer_duration ke nilai yang dipilih. Lihat referensi API untuk nilai yang diizinkan.

Tidak dapat menetapkan suhu rendah target lebih tinggi dari suhu tinggi target

Termostat dalam mode heat-cool , dan produk mencoba menyetel suhu target rendah / tinggi yang berada di luar kisaran. Misalnya, produk mencoba menyetel target_temperature_low_c ke 25 ° C ketika target_temperature_high_c adalah 24 ° C.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat menyetel suhu rendah target $lowTemp lebih tinggi dari suhu tinggi target $highTemp suhu tinggi
type https://developers.nest.com/reference/error-messages#low-high-error
message Tidak dapat menyetel suhu rendah target $lowTemp lebih tinggi dari suhu tinggi target $highTemp suhu tinggi
details $lowTemp
$highTemp

Tidak dapat menyetel suhu target lebih dekat dari N derajat C / F

Produk mencoba menetapkan nilai suhu target terlalu dekat dengan suhu tinggi / rendah target (misalnya, target_temperature_high_f ).

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat menyetel suhu target lebih dekat dari N derajat C / F
type https://developers.nest.com/reference/error-messages#range-error
message Tidak dapat menyetel suhu target lebih dekat dari $min derajat $scale
details $min
$scale

Tidak dapat menyetel target_temperature saat mode adalah $ mode

Termostat atau struktur saat ini dalam mode yang tidak mendukung permintaan API.

Misalnya, Anda tidak dapat menyetel target_temperature_f atau target_temperature_c saat sistem HVAC off atau dalam mode heat-cool . Nilainya tidak dapat diubah hingga termostat / struktur beralih kembali ke mode tidak terbatas.

Dalam pesan ini, $fieldName dapat berupa salah satu dari nilai suhu target dan $mode dapat berupa salah satu dari: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat menyetel target_temperature saat mode adalah $mode
type https://developers.nest.com/reference/error-messages#mode-error
message Tidak dapat menyetel $fieldName saat mode adalah $mode
details $fieldName
$mode

Pembaruan firmware perangkat diperlukan sebelum Anda dapat mengubah mode HVAC

Perangkat harus diperbarui ke versi firmware saat ini untuk mengatur Suhu Eko.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Pembaruan firmware perangkat diperlukan sebelum Anda dapat mengubah mode HVAC. Pembaruan dilakukan secara otomatis, biasanya dalam seminggu setelah rilis.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message Pembaruan firmware perangkat diperlukan sebelum Anda dapat mengubah mode HVAC. Pembaruan dilakukan secara otomatis, biasanya dalam seminggu setelah rilis.

Kesalahan saat memvalidasi bidang WWN

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Kesalahan saat memvalidasi bidang WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message Kesalahan saat memvalidasi bidang WWN: $error
details $error

ETA sudah lewat

Waktu ETA yang ditentukan sudah lewat (sebelum SEKARANG). Untuk informasi lebih lanjut tentang melakukan panggilan ETA, lihat Panduan Pergi & ETA .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ETA sudah lewat: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA sudah lewat: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA masih terlalu jauh di masa depan

Waktu ETA yang ditentukan tidak boleh lebih dari 8 jam ke depan. Untuk informasi lebih lanjut tentang melakukan panggilan ETA, lihat Panduan Pergi & ETA .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ETA masih terlalu jauh di masa depan
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA masih terlalu jauh di masa depan

fan_timer_active tidak disetel

fan_timer_active tidak ditentukan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error fan_timer_active tidak disetel
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active tidak disetel

Terlarang

Kredensial yang digunakan untuk mengakses layanan Nest tidak valid.

Parameter
Kode Status HTTP: 403 Terlarang
error Terlarang
type https://developers.nest.com/reference/error-messages#forbidden
message Terlarang

Kesalahan internal

Parameter
Kode Status HTTP: 500 Kesalahan Server Internal
error Kesalahan internal
type https://developers.nest.com/reference/error-messages#internal-error
message Kesalahan internal

ID kamera tidak valid

camera-id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ID kamera $id tidak valid
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message Id kamera tidak valid: $id
details $id

Konten yang dikirim tidak valid

Panggilan tersebut berisi konten yang tidak valid. Misalnya, menggunakan "ya" bukan "benar" untuk variabel boolean.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Konten yang dikirim tidak valid
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message Konten yang dikirim tidak valid

Jalur fragmen tidak valid

Bagian dari jalur permintaan tidak valid. Misalnya, nama objek atau bidang mungkin salah eja.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Jalur fragmen tidak valid: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message Jalur fragmen tidak valid: $requestPath
details $requestPath

Mode HVAC tidak valid

Sistem HVAC termostat tidak mendukung mode yang diminta oleh produk: heat , cool , atau heat-cool .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Mode HVAC tidak valid: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message Mode HVAC tidak valid: $mode
details $mode

ID alarm asap + co tidak valid

smoke_co_alarm_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ID alarm asap + co tidak valid $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message Id alarm asap + co tidak valid: $id
details $id

ID struktur tidak valid

structure_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ID struktur $id tidak valid
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message ID struktur tidak valid: $id
details $id

ID termostat tidak valid

thermostat_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error ID termostat $id tidak valid
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message ID termostat tidak valid: $id
details $id

Nilai tidak valid untuk Away

Anda mencoba menetapkan nilai yang tidak valid untuk away .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai tidak valid untuk Away
type https://developers.nest.com/reference/error-messages#invalid-away-value
message Nilai tidak valid: $value . Hanya nilai 'home' dan 'away' yang diizinkan.
details $value

is_streaming bukan boolean

Produk mencoba menyetel kolom is-streaming ke non-boolean.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error is_streaming bukan boolean
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming bukan boolean

Label harus kurang dari 256 karakter

Produk mencoba membuat label Termostat dengan lebih dari 256 karakter.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Label harus kurang dari $max_label_length karakter
type https://developers.nest.com/reference/error-messages#max-label-length
message Label harus kurang dari $max_label_length karakter
details $max_label_length

Kustom maksimum di mana jumlah terlampaui

Produk berusaha untuk membuat custom wheres objek luar maksimal. Jumlah maksimum kustom wheres benda yang diizinkan adalah 32.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Kustom maksimum di mana jumlah $max_where_count terlampaui
type https://developers.nest.com/reference/error-messages#max-where-count
message Kustom maksimum di mana jumlah $max_where_count terlampaui
details $max_where_count

Kustom maksimum di mana panjang nama terlampaui

Di mana name terlalu panjang. Kami merekomendasikan kurang dari 30 karakter.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Kustom maksimum di mana panjang nama $max_custom_where_name_length terlampaui
type https://developers.nest.com/reference/error-messages#max-where-name-length
message Kustom maksimum di mana panjang nama $max_custom_where_name_length terlampaui
details $max_custom_where_name_length

Bidang hilang

Panggilan tidak memiliki parameter wajib.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Bidang yang hilang: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Bidang yang hilang: $fieldName
details $fieldName

Hilang Di Mana ID

Format where_id hilang.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Id Tempat Hilang
type https://developers.nest.com/reference/error-messages#where-id-missing
message Id Tempat Hilang

Tidak ada kipas HVAC

Sistem HVAC tampaknya tidak memiliki kipas independen.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak ada kipas angin
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message Tidak ada kipas angin

Tidak ada termostat online

Termostat sedang offline. Setelah wi-fi diaktifkan, produk Anda akan mendapatkan kembali aksesnya.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak ada termostat online
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message Tidak ada termostat online

Tidak ada perangkat yang disandingkan

Perangkat Nest pengguna tidak disandingkan dengan Akun Nest pengguna .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak ada perangkat yang disandingkan
type https://developers.nest.com/reference/error-messages#no-paired-devices
message Tidak ada perangkat yang disandingkan

Tidak ada ETA yang valid untuk dibatalkan

Perjalanan tidak valid dan tidak dapat dibatalkan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak ada ETA yang valid untuk dibatalkan
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message Tidak ada ETA yang valid untuk dibatalkan

Tidak ada izin menulis untuk bidang

Klien tidak memiliki izin menulis untuk data ini. Untuk informasi selengkapnya, lihat Ringkasan Izin .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak ada izin menulis untuk bidang: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message Tidak ada izin menulis untuk bidang: $fields
details $fields

Bukan jenis permintaan yang valid

Jenis permintaan tidak valid. Misalnya, panggilan POST dilakukan saat PUT diperlukan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Bukan jenis permintaan yang valid: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message Bukan jenis permintaan yang valid: $requestType
details $requestType

Tidak ditemukan

Panggilan tersebut mencoba membaca jalur yang tidak ada.

Parameter
Kode Status HTTP: 404 Tidak Ditemukan
error Tidak ditemukan
type https://developers.nest.com/reference/error-messages#not-found
message Tidak ditemukan

Tidak dalam mode Jauh

Struktur tidak dalam mode Jauh saat panggilan ETA dilakukan. Panggilan ETA hanya diterima saat struktur disetel ke Jauh.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dalam mode Jauh
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Tidak dalam mode Jauh

Tidak bisa ditulis

Bidang yang Anda coba tulis adalah hanya-baca.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak bisa ditulis
type https://developers.nest.com/reference/error-messages#not-writable
message Tidak bisa ditulis

Hanya jika nama perlu diberikan

Bidang tambahan termasuk dalam wheres panggilan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Hanya jika nama perlu diberikan
type https://developers.nest.com/reference/error-messages#extra-fields
message Hanya jika nama perlu diberikan

POST bukan jenis permintaan yang valid

Jenis permintaan tidak valid. Misalnya, panggilan POST dilakukan saat PUT diperlukan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error POST bukan jenis permintaan yang valid
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST bukan jenis permintaan yang valid

Pelanggaran skema

Terjadi kesalahan saat memasangkan perangkat.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Pelanggaran skema
type https://developers.nest.com/reference/error-messages#schema-violation-error
message Pelanggaran skema

Layanan tidak tersedia

Parameter
Kode Status HTTP: 503 Layanan Tidak Tersedia
error Layanan tidak tersedia
type https://developers.nest.com/reference/error-messages#service-unavailable
message Layanan tidak tersedia

Struktur sudah memiliki jumlah maksimum perangkat yang dipasangkan yang diizinkan

Struktur sudah memiliki jumlah maksimum perangkat yang diizinkan .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Struktur sudah memiliki jumlah maksimum perangkat yang dipasangkan yang diizinkan
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message Struktur sudah memiliki jumlah maksimum perangkat yang dipasangkan yang diizinkan

Struktur tidak dimiliki oleh pengguna

structure_id tidak cocok dengan akun pengguna yang tercatat.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Struktur tidak dimiliki oleh pengguna.
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message Struktur tidak dimiliki oleh pengguna.

Suhu C terlalu tinggi untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk mencoba menyetel suhu target Celcius lebih tinggi dari rentang suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Suhu C $tempC terlalu tinggi untuk suhu kunci $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message Suhu C $tempC terlalu tinggi untuk suhu kunci $highLockTemp
details $tempC
$highLockTemp

Suhu C terlalu rendah untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk mencoba menyetel suhu target Celcius lebih rendah dari kisaran suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Suhu C $tempC terlalu rendah untuk suhu kunci $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message Suhu C $tempC terlalu rendah untuk suhu kunci $lowLockTemp
details $tempC
$lowLockTemp

Nilai suhu C terlalu tinggi

Produk mencoba menetapkan nilai suhu target yang terlalu tinggi untuk suhu Celcius. Untuk rentang suhu yang diizinkan dalam Celsius, lihat target_temperature_c .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai suhu C terlalu tinggi: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message Nilai suhu C terlalu tinggi: $tempC
details $tempC

Nilai suhu C terlalu rendah

Produk mencoba menetapkan nilai suhu target yang terlalu rendah untuk suhu Celcius. Untuk rentang suhu yang diizinkan dalam Celsius, lihat target_temperature_c .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai suhu C terlalu rendah: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message Nilai suhu C terlalu rendah: $tempC
details $tempC

Suhu F terlalu tinggi untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk mencoba menyetel suhu target Fahrenheit lebih tinggi dari kisaran suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Suhu F $tempF terlalu tinggi untuk suhu kunci $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message Suhu F $tempF terlalu tinggi untuk suhu kunci $highLockTemp
details $tempF
$highLockTemp

Suhu F terlalu rendah untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk mencoba menyetel suhu target Fahrenheit lebih rendah dari kisaran suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Suhu F $tempF terlalu rendah untuk suhu kunci $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message Suhu F $tempF terlalu rendah untuk suhu kunci $lowLockTemp
details $tempF
$lowLockTemp

Nilai suhu F terlalu tinggi

Produk mencoba menetapkan nilai suhu target yang terlalu tinggi untuk suhu Fahrenheit. Untuk rentang suhu yang diizinkan dalam Fahrenheit, lihat target_temperature_f .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai suhu F terlalu tinggi: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message Nilai suhu F terlalu tinggi: $tempF
details $tempF

Nilai suhu F terlalu rendah

Produk mencoba menetapkan nilai suhu target yang terlalu rendah untuk suhu Fahrenheit. Untuk rentang suhu yang diizinkan dalam Fahrenheit, lihat target_temperature_f .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai suhu F terlalu rendah: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message Nilai suhu F terlalu rendah: $tempF
details $tempF

Suhu dalam format yang salah

Produk berusaha untuk mengatur suhu target menggunakan format nomor yang salah untuk dipilih temperature_scale . Suhu Celsius harus berupa bilangan bulat dengan kenaikan 0,5 derajat (21,5), dan suhu Fahrenheit harus berupa bilangan bulat utuh (72).

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Suhu $temp dalam format yang salah
type https://developers.nest.com/reference/error-messages#format-error
message Suhu $temp dalam format yang salah
details $temp

Bidang tidak dapat diubah saat diperbarui

Produk mencoba menulis ke bidang hanya baca.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Bidang tidak dapat diubah pada pembaruan: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message Bidang tidak dapat diubah pada pembaruan: $fieldNames
details $fieldNames

Bidang harus menggunakan format ISO 8601

Bidang tidak dalam format ISO 8601 .

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Bidang harus menggunakan format ISO 8601: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message Bidang harus menggunakan format ISO 8601: $fieldNames
details $fieldNames

Termostat tidak online

Termostat sedang offline. Setelah wi-fi diaktifkan, produk Anda akan mendapatkan kembali aksesnya.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Termostat tidak online
type https://developers.nest.com/reference/error-messages#not-online
message Termostat tidak online

Perjalanan ini telah diganti secara manual

Pengguna telah mengganti perjalanan secara manual.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Perjalanan ini telah diganti secara manual
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message Perjalanan ini telah diganti secara manual

Tidak dapat membuat di mana ID

The wheres objek yang hilang. Tidak ada nilai where_id yang ditentukan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Tidak dapat membuat tempat id
type https://developers.nest.com/reference/error-messages#wheres-missing
message Tidak dapat membuat tempat id

Tidak resmi

Otorisasi gagal.

Beberapa kondisi dapat menghasilkan pesan kesalahan ini:

  • pengalihan salah yang terjadi saat implementasi HTTP tertentu tidak secara otomatis meneruskan header Otorisasi ke URI yang dialihkan. Untuk informasi lebih lanjut, lihat Bagaimana menangani pengalihan .

  • izin yang salah saat mencoba mengakses titik akhir API. Misalnya, mencoba membaca titik akhir Termostat ketika hanya izin Kamera yang dipilih untuk klien. Untuk informasi selengkapnya, lihat cara memilih izin .

Parameter
Kode Status HTTP: 401 Tidak Sah
error Tidak resmi
type https://developers.nest.com/reference/error-messages#auth-error
message Tidak resmi

Tidak diketahui

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error tidak diketahui
type https://developers.nest.com/reference/error-messages#unknown
message tidak diketahui

Vendor / jenis perangkat tidak diketahui

Vendor / perangkat tidak dikenali selama pemasangan perangkat.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Vendor / jenis perangkat tidak diketahui
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message Vendor / jenis perangkat tidak diketahui

Nilai $ fieldName adalah jenis yang salah

Jenis data yang dikirim salah. Misalnya, mengirim string saat boolean diharapkan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Nilai $fieldName adalah jenis yang salah
type https://developers.nest.com/reference/error-messages#wrong-data-type
message Nilai $fieldName adalah jenis yang salah
details $fieldName

Dimana nama sudah ada

where_name yang coba disetel produk sudah ada. Coba lagi dengan nama baru.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Dimana nama $name sudah ada
type https://developers.nest.com/reference/error-messages#where-name-exists
message Dimana nama $name sudah ada
details $name

Dimana nama tidak diberikan

where_name hilang dari panggilan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Dimana nama tidak diberikan
type https://developers.nest.com/reference/error-messages#where-name-missing
message Dimana nama tidak diberikan

Dimana nama panjangnya nol

Di mana name tidak ditentukan (memiliki karakter nol).

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Dimana nama panjangnya nol
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message Dimana nama panjangnya nol

Dimana nama harus berupa string

Jenis data yang salah dikirim untuk where_name . Misalnya, angka saat string diharapkan.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error Dimana nama harus berupa string
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Dimana nama harus berupa string

where_id tidak ada

where_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error where_id tidak ada
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id tidak ada
details $where_id

where_id harus berupa string

Format where_id tidak valid. Misalnya, nomor dikirim alih-alih string.

Parameter
Kode Status HTTP: 400 Permintaan Buruk
error where_id harus berupa string
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id harus berupa string

Kode dan pesan kesalahan lainnya

Kode kesalahan perangkat

Untuk kode kesalahan khusus perangkat dan pesan yang tidak terkait dengan Nest API, lihat yang berikut ini:

Kode kesalahan REST

Saat Anda melakukan panggilan REST API, kode status HTTP umum dikembalikan.

Pesan batas tingkat REST

Saat menggunakan REST dan Anda mengirim terlalu banyak panggilan dalam waktu singkat, Anda mungkin menerima kode status respons HTTP 429 Terlalu Banyak Permintaan.

Untuk informasi selengkapnya, lihat Batas Kecepatan Data .