よくある失敗
HTTPステータスとレスポンスの code をもとに対応を判断してください。message の文言で分岐しないでください。
| 症状 | 対応 |
|---|---|
AUTH_INVALID | clientId と clientSecret を確認する |
APP_DISABLED | API Clientとアプリケーションが有効になっているか確認する |
AUTH_SCOPE_DENIED | data.requiredScope で示された権限を追加し、新しいアクセストークンを取得する |
AUTH_EXPIRED | 新しいアクセストークンを取得し、失敗した読み取りを一度だけ再試行する |
data.devices が空 | デバイスがアカウントに属し、API Clientがアクセスできるか確認する |
RATE_LIMITED | Retry-After を待つ。すぐに再試行しない |
DEVICE_OFFLINE | 再接続を待つか、エンドポイントが提供する最後の同期済み状態を使う |
| コマンドに最終結果がない | コマンドIDで照会する。副作用のある操作を盲目的に繰り返さない |
サポートに連絡する際は requestId を記録してください。
その他のトラブルシューティング
- レスポンスの構造(英語)
- 認証・認可エラー(英語)
- リソース・コマンドエラー(英語)
- よくある質問
- サポートに連絡
