Pesan Kesalahan

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

Jika terjadi error selama panggilan API, respons dalam format ini akan 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 error berisi kolom error, type, message, dan instance. Objek details bersifat opsional.

Kolom Deskripsi
error Format pesan error singkat.
type Memberikan URL ke informasi mendetail tentang kondisi error (halaman ini).
message Format pesan error panjang yang mungkin menggunakan variabel untuk memberikan detail tambahan. Jika variabel disertakan dalam pesan, variabel tersebut akan muncul dalam objek details.
instance String teks yang menyimpan ID error yang bersifat unik untuk setiap panggilan. Kami dapat meminta nomor instance tersebut jika Anda melaporkan masalah terkait layanan.
details Opsional. Berisi variabel yang disisipkan ke dalam message. Pesan dapat berisi beberapa variabel.

Untuk informasi tentang error yang tidak terkait dengan Nest API, lihat Pesan dan kode error lainnya.

Diblokir

Batas kapasitas telah terlampaui.

Parameter
Kode Status HTTP: 429 Terlalu Banyak Permintaan
errorDiblokir
typehttps://developers.nest.com/reference/error-messages#blocked
messageDiblokir

Tidak dapat mengaktifkan kipas saat lampu berhenti/beraman saat berkendara

Penghentian Darurat berlaku. Panggilan API tidak akan diterima hingga operasi normal dipulihkan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat mengaktifkan kipas saat lampu berhenti/beraman saat berkendara
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageTidak dapat mengaktifkan kipas saat lampu berhenti/beraman saat berkendara

Tidak dapat mengubah status Pergi saat penghangat darurat aktif

Produk mencoba mengubah status Pergi saat Pemanasan Darurat diaktifkan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat mengubah status Pergi saat penghangat darurat aktif
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageTidak dapat mengubah status Pergi saat penghangat darurat aktif

Tidak dapat mengubah mode HVAC selama acara hemat energi

Peristiwa hemat energi yang ditetapkan oleh partner energi Nest sedang diberlakukan. Panggilan API ditolak hingga peristiwa hemat energi berakhir.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat mengubah mode HVAC selama acara hemat energi
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageTidak dapat mengubah mode HVAC selama acara hemat energi

Tidak dapat mengubah mode HVAC

Mode tidak kompatibel 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 ditetapkan ke eco dan produk mencoba menyetel target_temperature
Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat mengubah mode HVAC ke $mode; HVAC tidak dapat $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageTidak dapat mengubah mode HVAC ke $mode; HVAC tidak dapat $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 Tidak Valid
errorTidak dapat mengubah mode HVAC saat kunci termostat diaktifkan
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageTidak dapat mengubah mode HVAC saat kunci termostat diaktifkan

Tidak dapat menyetel suhu C dan F secara bersamaan

Produk ini mencoba menetapkan suhu target Celsius dan Fahrenheit secara bersamaan. Produk hanya boleh menetapkan suhu target yang ditentukan oleh temperature_scale (C/F).

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat menyetel suhu C dan F secara bersamaan
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageTidak dapat menyetel suhu C dan F secara bersamaan

Tidak dapat mengaktifkan/menonaktifkan fan_timer_active karena mode tidak kompatibel

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

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat mengaktifkan/menonaktifkan fan_timer_active karena mode tidak kompatibel $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageTidak dapat mengaktifkan/menonaktifkan fan_timer_active karena mode tidak kompatibel $mode
details$mode

Tidak dapat menyetel fan_timer_duration ke nilai yang dipilih

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat menyetel fan_timer_duration ke nilai yang dipilih. Lihat referensi API untuk mengetahui nilai yang diizinkan.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageTidak dapat menyetel fan_timer_duration ke nilai yang dipilih. Lihat referensi API untuk mengetahui nilai yang diizinkan.

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

Termostat dalam mode heat-cool, dan produk berusaha menetapkan suhu target rendah/tinggi yang berada di luar rentang. Misalnya, produk yang dicoba menyetel target_temperature_low_c ke 25°C jika target_temperature_high_c 24°C.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat menetapkan target suhu rendah $lowTemp lebih tinggi dari target suhu tinggi $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageTidak dapat menetapkan target suhu rendah $lowTemp lebih tinggi dari target suhu tinggi $highTemp
details$lowTemp
$highTemp

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

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat menetapkan suhu target lebih dekat dari N derajat C/F
typehttps://developers.nest.com/reference/error-messages#range-error
messageTidak dapat menetapkan suhu target yang 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 berada dalam mode off atau heat-cool. Nilai tidak dapat diubah hingga termostat/struktur beralih kembali ke mode yang tidak dibatasi.

Dalam pesan ini,$fieldName dapat berupa salah satu 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 Tidak Valid
errorTidak dapat menyetel target_temperature saat mode $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageTidak dapat menyetel $fieldName saat mode $mode
details$fieldName
$mode

Diperlukan update firmware perangkat sebelum Anda dapat mengubah mode HVAC

Perangkat harus diupdate ke versi firmware saat ini untuk menetapkan Suhu Hemat Energi.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorDiperlukan update firmware perangkat sebelum Anda dapat mengubah mode HVAC. Update dilakukan secara otomatis, biasanya dalam waktu satu minggu setelah rilis.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageDiperlukan update firmware perangkat sebelum Anda dapat mengubah mode HVAC. Update dilakukan secara otomatis, biasanya dalam waktu satu minggu setelah rilis.

Terjadi error saat memvalidasi kolom WWN

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTerjadi error saat memvalidasi kolom WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageTerjadi error saat memvalidasi kolom WWN: $error
details$error

ETA sudah lewat

Waktu PWT yang ditentukan ada di masa lalu (sebelum SEKARANG). Untuk informasi lebih lanjut cara melakukan panggilan PWT, lihat Panduan Pergi &Pergi.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorETA sudah lewat: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageETA sudah lewat: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

PWT terlalu jauh di masa mendatang

Waktu PWT yang ditentukan tidak boleh lebih dari 8 jam di masa mendatang. Untuk informasi selengkapnya dalam melakukan panggilan PWT, lihat Panduan Pergi &Pergi.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorPWT terlalu jauh di masa mendatang
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messagePWT terlalu jauh di masa mendatang

fan_timer_active tidak disetel

fan_timer_active tidak ditetapkan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorfan_timer_active tidak disetel
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagefan_timer_active tidak disetel

Akses Dilarang

Kredensial yang digunakan untuk mengakses layanan Nest tidak valid.

Parameter
Kode Status HTTP: 403 Forbidden
errorAkses Dilarang
typehttps://developers.nest.com/reference/error-messages#forbidden
messageAkses Dilarang

Error internal

Parameter
Kode Status HTTP: Error Server Internal 500
errorError Internal
typehttps://developers.nest.com/reference/error-messages#internal-error
messageError Internal

ID kamera tidak valid

camera-id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorID kamera tidak valid $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageID kamera tidak valid: $id
details$id

Konten yang dikirim tidak valid

Panggilan ini berisi konten tidak valid. Misalnya, menggunakan "ya" bukan "true" untuk variabel boolean.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKonten yang dikirim tidak valid
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageKonten yang dikirim tidak valid

Jalur fragmen tidak valid

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorJalur fragmen tidak valid: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageJalur 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 Tidak Valid
errorMode HVAC tidak valid: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageMode HVAC tidak valid: $mode
details$mode

ID alarm asap+co tidak valid

smoke_co_alarm_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorID alarm asap+co $id tidak valid
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID alarm asap+co tidak valid: $id
details$id

ID struktur tidak valid

structure_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorID struktur tidak valid $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageID struktur tidak valid: $id
details$id

ID termostat tidak valid

thermostat_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorID termostat tidak valid $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageID termostat tidak valid: $id
details$id

Nilai tidak ada untuk Pergi

Anda mencoba menetapkan nilai yang tidak valid untuk away.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorNilai tidak ada untuk Pergi
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageNilai tidak valid: $value. Hanya 'rumah' dan 'pergi' yang diizinkan nilai.
details$value

is_streaming bukan boolean

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
erroris_streaming bukan boolean
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming bukan boolean

Label harus kurang dari 256 karakter

Produk ini mencoba membuat label Termostat dengan lebih dari 256 karakter.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorLabel harus kurang dari $max_label_length karakter
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageLabel harus kurang dari $max_label_length karakter
details$max_label_length

Kustom maksimum dengan jumlah terlampaui

Produk mencoba membuat objek wheres kustom melebihi batas maksimum. Jumlah maksimum objek wheres kustom yang diizinkan adalah 32.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKustom maksimum dengan jumlah $max_where_count terlampaui
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageKustom maksimum dengan jumlah $max_where_count terlampaui
details$max_where_count

Kustom maks. jika panjang nama terlampaui

name terlalu panjang. Sebaiknya gunakan teks kurang dari 30 karakter.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKustom maks. jika panjang nama melebihi $max_custom_where_name_length
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageKustom maks. jika panjang nama melebihi $max_custom_where_name_length
details$max_custom_where_name_length

Bidang yang tidak ada

Panggilan tidak memiliki parameter wajib.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorBidang hilang: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageBidang hilang: $fieldName
details$fieldName

ID Tempat Tidak Ada

Format where_id tidak ada.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorID Tempat Tidak Ada
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageID Tempat Tidak Ada

Tidak memiliki kipas HVAC

Sistem HVAC tampaknya tidak memiliki kipas independen.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak menyediakan kipas angin
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageTidak menyediakan kipas angin

Tidak ada termostat online

Termostat saat ini sedang offline. Setelah Wi-Fi diaktifkan, produk Anda akan memperoleh akses kembali.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak ada termostat online
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageTidak ada termostat online

Tidak ada perangkat yang terhubung

Perangkat Nest pengguna tidak dipasangkan dengan Akun Nest pengguna.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak ada perangkat yang terhubung
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageTidak ada perangkat yang terhubung

Tidak ada PWT yang valid untuk dibatalkan

Perjalanan tidak valid dan tidak dapat dibatalkan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak ada PWT yang valid untuk dibatalkan
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageTidak ada PWT yang valid untuk dibatalkan

Tidak ada izin menulis untuk kolom

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak memiliki izin menulis untuk kolom: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageTidak memiliki izin menulis untuk kolom: $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 Tidak Valid
errorBukan jenis permintaan yang valid: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageBukan jenis permintaan yang valid: $requestType
details$requestType

Tidak ditemukan

Panggilan telepon tersebut mencoba membaca jalur yang tidak ada.

Parameter
Kode Status HTTP: 404 Tidak Ditemukan
errorTidak ditemukan
typehttps://developers.nest.com/reference/error-messages#not-found
messageTidak ditemukan

Tidak dalam mode Pergi

Struktur tidak dalam mode Pergi saat panggilan PWT dilakukan. Panggilan ETA hanya diterima jika struktur ditetapkan ke mode Pergi.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dalam mode Pergi
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageTidak dalam mode Pergi

Tidak dapat ditulis

Kolom yang berupaya Anda tulis bersifat hanya-baca.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat ditulis
typehttps://developers.nest.com/reference/error-messages#not-writable
messageTidak dapat ditulis

Hanya tempat nama perlu disediakan

Kolom tambahan disertakan dalam panggilan wheres.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorHanya tempat nama perlu disediakan
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageHanya tempat nama perlu disediakan

POST bukan jenis permintaan yang valid

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorPOST bukan jenis permintaan yang valid
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST bukan jenis permintaan yang valid

Pelanggaran skema

Terjadi kesalahan saat memasangkan perangkat.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorPelanggaran skema
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messagePelanggaran skema

Layanan tidak tersedia

Parameter
Kode Status HTTP: Layanan 503 Tidak Tersedia
errorLayanan Tidak Tersedia
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageLayanan Tidak Tersedia

Struktur sudah memiliki jumlah maksimum perangkat yang disambungkan

Struktur ini sudah memiliki jumlah maksimum perangkat yang diizinkan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorStruktur sudah memiliki jumlah maksimum perangkat yang disambungkan
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageStruktur sudah memiliki jumlah maksimum perangkat yang disambungkan

Struktur tidak dimiliki oleh pengguna

structure_id tidak cocok dengan akun pengguna yang tercatat.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorStruktur tidak dimiliki oleh pengguna.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageStruktur tidak dimiliki oleh pengguna.

Suhu C terlalu tinggi untuk suhu penguncian

Termostat telah dikunci oleh pengguna dan produk berusaha menetapkan suhu target Celsius yang lebih tinggi dari rentang suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorSuhu C $tempC terlalu tinggi untuk suhu penguncian $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageSuhu C $tempC terlalu tinggi untuk suhu penguncian $highLockTemp
details$tempC
$highLockTemp

Suhu C terlalu rendah untuk suhu penguncian

Termostat telah dikunci oleh pengguna dan produk berusaha menetapkan suhu target Celsius yang lebih rendah dari rentang suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorSuhu C $tempC terlalu rendah untuk suhu penguncian $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageSuhu C $tempC terlalu rendah untuk suhu penguncian $lowLockTemp
details$tempC
$lowLockTemp

Nilai suhu C terlalu tinggi

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorNilai Suhu C terlalu tinggi: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageNilai Suhu C terlalu tinggi: $tempC
details$tempC

Nilai suhu C terlalu rendah

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorNilai Suhu C terlalu rendah: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageNilai Suhu C terlalu rendah: $tempC
details$tempC

Suhu F terlalu tinggi untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk berupaya menetapkan suhu target Fahrenheit yang lebih tinggi daripada rentang suhu penguncian.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorSuhu F $tempF terlalu tinggi untuk suhu penguncian $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageSuhu F $tempF terlalu tinggi untuk suhu penguncian $highLockTemp
details$tempF
$highLockTemp

Suhu F terlalu rendah untuk suhu kunci

Termostat telah dikunci oleh pengguna dan produk berusaha menetapkan suhu target Fahrenheit yang lebih rendah dari rentang suhu kunci.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorSuhu F $tempF terlalu rendah untuk suhu penguncian $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageSuhu F $tempF terlalu rendah untuk suhu penguncian $lowLockTemp
details$tempF
$lowLockTemp

Nilai F suhu 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 Tidak Valid
errorNilai F suhu terlalu tinggi: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageNilai F suhu terlalu tinggi: $tempF
details$tempF

Nilai F suhu 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 Tidak Valid
errorNilai F suhu terlalu rendah: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageNilai F suhu terlalu rendah: $tempF
details$tempF

Suhu dalam format yang salah

Produk mencoba menetapkan suhu target menggunakan format angka yang salah untuk temperature_scale yang dipilih. Suhu Celsius harus berupa bilangan bulat dengan peningkatan 0,5 derajat (21,5), dan suhu Fahrenheit harus berupa bilangan bulat bulat (72).

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorSuhu $temp dalam format yang salah
typehttps://developers.nest.com/reference/error-messages#format-error
messageSuhu $temp dalam format yang salah
details$temp

Kolom tidak dapat diubah saat update

Produk mencoba menulis ke kolom hanya baca.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKolom tidak dapat diubah saat update: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageKolom tidak dapat diubah saat update: $fieldNames
details$fieldNames

Kolom harus menggunakan format ISO 8601

Kolom tidak dalam format ISO 8601.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKolom harus menggunakan format ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageKolom harus menggunakan format ISO 8601: $fieldNames
details$fieldNames

Termostat tidak online

Termostat saat ini sedang offline. Setelah Wi-Fi diaktifkan, produk Anda akan memperoleh akses kembali.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTermostat tidak online
typehttps://developers.nest.com/reference/error-messages#not-online
messageTermostat tidak online

Perjalanan ini telah diganti secara manual

Pengguna telah mengganti perjalanan secara manual.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorPerjalanan ini telah diganti secara manual
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messagePerjalanan ini telah diganti secara manual

Tidak dapat membuat ID tempat

Objek wheres tidak ada. Tidak ada nilai where_id yang ditentukan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTidak dapat membuat ID tempat
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageTidak dapat membuat ID tempat

Tidak berizin

Otorisasi gagal.

Beberapa kondisi dapat menghasilkan pesan error ini:

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

  • izin yang salah saat mencoba mengakses endpoint API. Misalnya, mencoba membaca endpoint Thermostat jika hanya izin Kamera yang dipilih untuk klien. Untuk mengetahui informasi selengkapnya, lihat Cara memilih izin.

Parameter
Kode Status HTTP: 401 Tidak Sah
errorTidak berizin
typehttps://developers.nest.com/reference/error-messages#auth-error
messageTidak berizin

Tidak diketahui

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errortidak diketahui
typehttps://developers.nest.com/reference/error-messages#unknown
messagetidak diketahui

Jenis perangkat/vendor tidak dikenal

Vendor/perangkat tidak dikenali selama penyambungan perangkat.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorJenis perangkat/vendor tidak dikenal
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageJenis perangkat/vendor tidak dikenal

Nilai $fieldName adalah jenis yang salah

Jenis data yang dikirimkan salah. Misalnya, mengirim string jika ada boolean.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorNilai $fieldName adalah jenis yang salah
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageNilai $fieldName adalah jenis yang salah
details$fieldName

Tempat nama sudah ada

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTempat nama $name sudah ada
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageTempat nama $name sudah ada
details$name

Tempat nama tidak disediakan

where_name tidak ada dalam panggilan.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorTempat nama tidak disediakan
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageTempat nama tidak disediakan

Dengan nama panjangnya nol

name tidak ditentukan (memiliki karakter nol).

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorDengan nama panjangnya nol
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageDengan nama panjangnya nol

Ketika nama harus berupa string

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

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorKetika nama harus berupa string
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageKetika nama harus berupa string

where_id tidak ada

where_id tidak valid.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorwhere_id tidak ada
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagewhere_id tidak ada
details$where_id

Where_id harus berupa string

Format where_id tidak valid. Misalnya, angka dikirim sebagai ganti string.

Parameter
Kode Status HTTP: 400 Permintaan Tidak Valid
errorWhere_id harus berupa string
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageWhere_id harus berupa string

Pesan dan kode error lainnya

Kode error perangkat

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

Kode error REST

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

Pesan batas kapasitas REST

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

Untuk informasi lebih lanjut, lihat Batas Tarif Data.