エラー状態は開発サイクルの一部であり、無効なパラメータや不足しているパラメータなどの単純な障害から、予期しない状態やデバイス関連の設定などの複雑なシナリオなどがあり、API の外部で解決する必要があります。
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
オブジェクトはオプションです。
項目 | Description |
---|---|
error |
短いエラー メッセージ形式。 |
type
|
エラー状態に関する詳細情報の URL(このページ)。 |
message
|
詳細なエラー メッセージ形式。変数を使用して追加情報を提供する場合もあります。変数がメッセージに含まれている場合、その変数は details オブジェクトに表示されます。 |
instance
|
個々の呼び出しに固有のエラー識別子を保持するテキスト文字列。サービスの問題を報告する場合は、インスタンス番号を求めることがあります。 |
details
|
省略可。message に挿入される変数が含まれます。メッセージには複数の変数を含めることができます。 |
Nest API に関連しないエラーについては、その他のエラーコードとメッセージをご覧ください。
ブロック
レート制限を超えました。
パラメータ | |
---|---|
HTTP ステータス コード: 429 Too Many Requests | |
error | ブロック |
type | https://developers.nest.com/reference/error-messages#blocked |
message | ブロック |
煙または一酸化炭素の安全遮断時に扇風機を起動できない
緊急遮断機能が有効になっています。API 呼び出しは、通常のオペレーションが復元されるまで受け入れられません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 煙または一酸化炭素の安全遮断時に扇風機を起動できない |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | 煙または一酸化炭素の安全遮断時に扇風機を起動できない |
緊急ヒーターがオンのときは外出ステータスを変更できません
緊急暖房が有効になっているときに、プロダクトが外出ステータスを変更しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 緊急ヒーターがオンのときは外出ステータスを変更できません |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | 緊急ヒーターがオンのときは外出ステータスを変更できません |
省エネ中に暖房換気空調モードを変更することはできません
Nest エネルギー パートナーによって定義された省エネイベントが有効になっている。省エネ イベントが終了するまで API 呼び出しは拒否されます。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 省エネ中に暖房換気空調モードを変更することはできません |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | 省エネ中に暖房換気空調モードを変更することはできません |
暖房換気空調モードは変更できません
モードがリクエストに対応していません。
たとえば、次のような場合に表示されます。
- Thermostat の HVAC システムは、製品からリクエストされたモード(
heat
、cool
、heat-cool
、eco
)をサポートしていません。 - HVAC モードが
eco
に設定され、プロダクトがtarget_temperature
を設定しようとしている
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 暖房換気空調モードを $mode に変更できません。暖房換気空調システムで $action を行うことはできません |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | 暖房換気空調モードを $mode に変更できません。暖房換気空調システムで $action を行うことはできません |
details | $mode |
サーモスタットのロックが有効になっている場合は、暖房換気空調モードを変更できません
プロダクトでデータを書き込むには、ユーザーがサーモスタットのロックを解除している必要があります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | サーモスタットのロックが有効になっている場合は、暖房換気空調モードを変更できません |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | サーモスタットのロックが有効になっている場合は、暖房換気空調モードを変更できません |
C と F の温度を同時に設定することはできません
製品は、摂氏と華氏の両方の目標温度を同時に設定しようとしました。製品は、temperature_scale
(C/F)で指定された目標温度のみを設定する必要があります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | C と F の温度を同時に設定することはできません |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | C と F の温度を同時に設定することはできません |
非対応モードのため、fan_timer_active をオンまたはオフにできません
HVAC システムのファンがすでに作動しているか(ユーザーが手動またはスケジュール設定しているか、HVAC の暖房/冷房サイクルにより)。
期待どおりの結果が得られない場合、API でオーバーライドできない動作がデバイスにある可能性があります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 非対応モード $mode のため、fan_timer_active をオンまたはオフにできません |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | 非対応モード $mode のため、fan_timer_active をオンまたはオフにできません |
details | $mode |
fan_timer_duration を選択された値に設定することはできません
商品が fan_timer_duration
を無効な値に設定しようとしました。有効な値の一覧については fan_timer_duration
をご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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_high_c
が 24°C のときに、target_temperature_low_c
を 25°C に設定しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 最低温度を目標$lowTemp より高く設定することはできません$highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | 最低温度を目標$lowTemp より高く設定することはできません$highTemp |
details | $lowTemp |
設定温度を °C より高く設定することはできません
本製品は、設定温度を目標高温 / 低温値(target_temperature_high_f
など)に非常に近づけようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 設定温度を °C より高く設定することはできません |
type | https://developers.nest.com/reference/error-messages#range-error |
message | 目標温度は $min 度 $scale より低く設定することはできません |
details | $min $scale |
モードが $mode の場合は target_temperature を設定できません
現在、サーモスタットまたはストラクチャが API リクエストをサポートしていないモードになっている。
たとえば、HVAC システムが off
モードまたは heat-cool
モードのときは、target_temperature_f
または target_temperature_c
を設定できません。サーモスタット/ストラクチャを制限付きモードに戻すまで、値を変更することはできません。
このメッセージでは、$fieldName
には目標温度値を指定できます。$mode
には eco
、emer_heat_enable
、heat-cool
、heat
、cool
、off
、hvac_safety_shutoff_active
を指定できます。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | モードが $mode の場合、target_temperature を設定できません |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | モードが $mode のときは $fieldName を設定できません |
details | $fieldName |
暖房換気空調モードを変更するにはデバイスのファームウェアの更新が必要です
エコ温度を設定するには、デバイスを現在のファームウェア バージョンに更新する必要があります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 暖房換気空調モードを変更するには、デバイスのファームウェアを更新してください。更新は通常、リリースの 1 週間以内に自動的に行われます。 |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | 暖房換気空調モードを変更するには、デバイスのファームウェアを更新してください。更新は通常、リリースの 1 週間以内に自動的に行われます。 |
WWN フィールドの検証中にエラーが発生しました
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | WWN フィールドの検証中にエラーが発生しました: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | WWN フィールドの検証中にエラーが発生しました: $error |
details | $error |
到着予定時刻が過ぎています
指定された到着予定時刻が過去の日時です(現在より前)。ETA 呼び出しについて詳しくは、外出 / ETA ガイドをご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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 時間以内にする必要があります。ETA 呼び出しについて詳しくは、外出 / ETA ガイドをご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 到着予定時刻が遠すぎる |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | 到着予定時刻が遠すぎる |
fan_timer_active が設定されていません
fan_timer_active
が定義されていません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | fan_timer_active が設定されていません |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active が設定されていません |
アクセス禁止
Nest サービスへのアクセスに使用している認証情報が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 403 Forbidden | |
error | アクセス禁止 |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | アクセス禁止 |
内部エラー
パラメータ | |
---|---|
HTTP ステータス コード: 500 Internal Server Error | |
error | 内部エラー |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | 内部エラー |
カメラ ID が無効です
camera-id
が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | カメラ ID $id が無効です |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | 無効なカメラ ID: $id |
details | $id |
無効なコンテンツが送信されました
呼び出しに無効なコンテンツが含まれています。たとえば、ブール変数の場合は "true" の代わりに &yes を使用します。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 無効なコンテンツが送信されました |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | 無効なコンテンツが送信されました |
フラグメント パスが無効です
リクエストパスの一部が無効です。たとえば、オブジェクトやフィールド名のスペルが間違っている可能性があります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 無効なフラグメントパス: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | 無効なフラグメントパス: $requestPath |
details | $requestPath |
無効な暖房換気空調モード
サーモスタットの暖房換気空調システムは、heat
、cool
、heat-cool
のうちでリクエストされたモードをサポートしていません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 無効な暖房換気空調モード: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | 無効な暖房換気空調モード: $mode |
details | $mode |
煙・一酸化炭素警報 ID が無効です
smoke_co_alarm_id
が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 煙・一酸化炭素警報 ID が無効です $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | 煙・一酸化炭素警報 ID が無効です: $id |
details | $id |
ストラクチャ ID が無効です
structure_id
が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | ストラクチャ ID $id が無効です |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | 無効なストラクチャ ID です: $id |
details | $id |
無効なサーモスタット ID です
thermostat_id
が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | サーモスタット ID $id が無効です |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | 無効なサーモスタット ID: $id |
details | $id |
外出の値が無効です
away
に無効な値を設定しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 外出の値が無効です |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | 無効な値: $value 指定できる値は 'home' と 'away' のみです。 |
details | $value |
is_streaming がブール値でない
商品が is-streaming
フィールドを非ブール値に設定しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | is_streaming がブール値でない |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming がブール値でない |
ラベルは 256 文字未満で指定する必要があります
製品は、256 文字を超えるサーモスタット ラベルを作成しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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 Bad Request | |
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 Bad Request | |
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 Bad Request | |
error | 次の欄が入力されていません: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | 次の欄が入力されていません: $fieldName |
details | $fieldName |
場所 ID がありません
where_id
形式が指定されていません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 場所 ID がありません |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | 場所 ID がありません |
暖房換気空調システムのファンがない
暖房換気空調システムには、独立したファンがないようです。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 空調ファンなし |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | 空調ファンなし |
オンライン サーモスタットなし
サーモスタットは現在オフラインです。Wi-Fi が有効になると、製品に再びアクセスできるようになります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | オンライン サーモスタットなし |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | オンライン サーモスタットなし |
ペア設定されたデバイスがありません
ユーザーの Nest デバイスがユーザーの Nest アカウントとペア設定されていない。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | ペア設定されたデバイスがありません |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | ペア設定されたデバイスがありません |
キャンセルできる有効な到着予定時刻がありません
このルートは無効であり、キャンセルできません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | キャンセルできる有効な到着予定時刻がありません |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | キャンセルできる有効な到着予定時刻がありません |
フィールドの書き込み権限がありません
クライアントにこのデータに対する書き込み権限がありません。詳細については、権限の概要をご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 次のフィールドへの書き込み権限がありません: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | 次のフィールドへの書き込み権限がありません: $fields |
details | $fields |
有効なリクエスト タイプではありません
リクエスト タイプが無効です。たとえば、PUT が必要な場合に POST 呼び出しが行われています。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 有効なリクエスト タイプではありません: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | 有効なリクエスト タイプではありません: $requestType |
details | $requestType |
見つかりませんでした
存在しないパスの読み取りを呼び出しました。
パラメータ | |
---|---|
HTTP ステータス コード: 404 Not Found | |
error | 見つかりませんでした |
type | https://developers.nest.com/reference/error-messages#not-found |
message | 見つかりませんでした |
外出モード以外
ETA を呼び出したとき、ストラクチャがアウェイ モードになっていません。ETA 通話は、ストラクチャが「外出」に設定されている場合にのみ受け入れられます。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 外出モード以外 |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | 外出モード以外 |
書き込み不可
書き込もうとしているフィールドは読み取り専用です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 書き込み不可 |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | 書き込み不可 |
名前を指定する必要がある場所のみ
余分なフィールドは wheres
の呼び出しに含まれていました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 名前を指定する必要がある場所のみ |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | 名前を指定する必要がある場所のみ |
POST は有効なリクエスト タイプではありません
リクエスト タイプが無効です。たとえば、PUT が必要な場合に POST 呼び出しが行われています。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | POST は有効なリクエスト タイプではありません |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST は有効なリクエスト タイプではありません |
スキーマの違反
デバイスのペア設定中にエラーが発生しました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | スキーマの違反 |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | スキーマの違反 |
サービスを利用できません
パラメータ | |
---|---|
HTTP ステータス コード: 503 Service Unavailable | |
error | サービス利用不可 |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | サービス利用不可 |
ストラクチャにペア設定できるデバイスの数が上限に達しています
ストラクチャに、許可されているデバイスの最大数がすでにあります。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | ストラクチャにペア設定できるデバイスの数が上限に達しています |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | ストラクチャにペア設定できるデバイスの数が上限に達しています |
お客様がストラクチャを所有していません
structure_id
がレコードのユーザー アカウントと一致しません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | お客様がストラクチャを所有していません。 |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | お客様がストラクチャを所有していません。 |
温度 C は高すぎてロック温度にできません
サーモスタットがユーザーによってロックされ、製品がロック温度範囲を超える摂氏目標温度を設定しようとしました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 温度 $tempC は、ロック温度 $highLockTemp に対して高すぎます |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | 温度 $tempC は、ロック温度 $highLockTemp に対して高すぎます |
details | $tempC |
温度 C は低すぎてロック温度にできません
サーモスタットがユーザーによってロックされ、製品がロック温度範囲よりも低い摂氏設定温度を設定しようとした。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 温度 $tempC は、ロック温度 $lowLockTemp に対して低すぎます |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | 温度 $tempC は、ロック温度 $lowLockTemp に対して低すぎます |
details | $tempC |
温度 C の値が高すぎます
商品は、摂氏温度に対して高すぎる目標値を設定しようとしました。摂氏で許可されている温度範囲については、target_temperature_c
をご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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 Bad Request | |
error | 温度 C の値が低すぎます: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | 温度 C の値が低すぎます: $tempC |
details | $tempC |
温度 F は高すぎてロック温度にできません
サーモスタットがユーザーによってロックされ、製品がロック温度範囲を超える設定温度を気温に設定しようとした。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 温度 $tempF は、ロック温度 $highLockTemp に対して高すぎます |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | 温度 $tempF は、ロック温度 $highLockTemp に対して高すぎます |
details | $tempF |
温度 F は低すぎてロック温度にできません
サーモスタットがユーザーによってロックされており、製品がロック温度範囲より低い目標温度を設定しようとしている。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 温度 $tempF は、ロック温度 $lowLockTemp に対して低すぎます |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | 温度 $tempF は、ロック温度 $lowLockTemp に対して低すぎます |
details | $tempF |
温度 F の値が高すぎます
目標設定温度である度が高すぎると、華氏を設定しようとしました。許容温度の範囲(華氏)については、target_temperature_f
をご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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 Bad Request | |
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 Bad Request | |
error | 温度 $temp は不適切な形式です。 |
type | https://developers.nest.com/reference/error-messages#format-error |
message | 温度 $temp は不適切な形式です。 |
details | $temp |
アップデート時にフィールドを変更することはできません
プロダクトが読み取り専用フィールドへの書き込みを試みました。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 次のフィールドは変更できません: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | 次のフィールドは変更できません: $fieldNames |
details | $fieldNames |
ISO 8601 形式を指定します。
フィールドが ISO 8601 形式ではありません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
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 Bad Request | |
error | サーモスタットはオンラインではありません |
type | https://developers.nest.com/reference/error-messages#not-online |
message | サーモスタットはオンラインではありません |
このルートは手動でオーバーライドされました
ユーザーが手動でルートをオーバーライドした。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | このルートは手動でオーバーライドされました |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | このルートは手動でオーバーライドされました |
場所 ID を作成できません
wheres
オブジェクトがない。where_id
値は定義されません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 場所 ID を作成できません |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | 場所 ID を作成できません |
未承認
認証に失敗しました。
このエラー メッセージが表示される原因は 2 つあります。
特定の HTTP 実装で Authorization ヘッダーが自動的にリダイレクト URI に転送されない場合に発生します。詳細については、リダイレクトを処理する方法をご覧ください。
API エンドポイントにアクセスしようとしたときに不正な権限。たとえば、クライアントに対してカメラ権限のみが選択されているときに、サーモスタット エンドポイントの読み取りを試みます。詳細については、権限を選択する方法をご覧ください。
パラメータ | |
---|---|
HTTP ステータス コード: 401 Unauthorized | |
error | 未承認 |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | 未承認 |
不明
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 不明 |
type | https://developers.nest.com/reference/error-messages#unknown |
message | 不明 |
不明なベンダー/デバイスタイプ
デバイスのペア設定中にベンダーまたはデバイスが認識されない。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 不明なベンダー/デバイスタイプ |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | 不明なベンダー/デバイスタイプ |
$fieldName のタイプが間違っています
間違ったデータタイプが送信されました。たとえば、ブール値が想定されている文字列の送信です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | $fieldName のタイプが間違っています |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | $fieldName のタイプが間違っています |
details | $fieldName |
名前がすでに存在する場所
商品が設定しようとした where_name
はすでに存在します。新しい名前でもう一度お試しください。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 「$name 」という名前がすでに存在します |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | 「$name 」という名前がすでに存在します |
details | $name |
名前が指定されていない場合
呼び出しに where_name
がありません。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 名前が指定されていない場合 |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | 名前が指定されていない場合 |
名前の長さがゼロです
name
が定義されていない(ゼロ文字)。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 名前の長さがゼロです |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | 名前の長さがゼロです |
名前は文字列で指定する必要があります
where_name
に対して間違ったデータ型が送信されました。たとえば、文字列が想定される数値です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | 名前は文字列で指定する必要があります |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | 名前は文字列で指定する必要があります |
where_id は存在しません
where_id
が無効です。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | where_id は存在しません |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | where_id は存在しません |
details | $where_id |
where_id は文字列で指定する必要があります
where_id
の形式は無効です。たとえば、文字列ではなく数値が送信された場合などです。
パラメータ | |
---|---|
HTTP ステータス コード: 400 Bad Request | |
error | where_id は文字列で指定する必要があります |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | where_id は文字列で指定する必要があります |
その他のエラーコードとメッセージ
デバイスのエラーコード
デバイス固有のエラーコードや、Nest API とは関係のないメッセージについては、以下をご覧ください。
REST エラーコード
REST API 呼び出しを行うと、一般的な HTTP ステータス コードが返されます。
REST レート制限メッセージ
REST を使用して短期間に大量の呼び出しを行うと、HTTP レスポンス ステータス コード「429 Too Many Requests」が返されることがあります。
詳細については、データ レート制限をご覧ください。