iobroker.hydrawise 1.1.0 → 2.0.0

package/README.md

@@ -23,6 +23,11 @@
 Integrate your Hydrawise controller into iobroker.
 You can see all controller information, schedules and sensors. It is also possible to suspend planned watering by x seconds.
 
+The adapter can use either API, or both:
+
+- **v1** (optional, API key, `schedule.*` / `customer.*`) — status, sensors configuration, run/stop/suspend.
+- **v2** (optional, Hydrawise login, `zones.*` / `water.*` / `sensors.*` / `weather.*` / `controller.*`) — measured water usage, live sensor values, weather, leak indicator, and zone commands via GraphQL.
+
 ## Documentation
 
 - log into https://app.hydrawise.com/config/account-details
@@ -30,6 +35,24 @@ You can see all controller information, schedules and sensors. It is also possib
 - paste key into adapter settings
 - API documentation: https://support.hydrawise.com/hc/en-us/articles/360008965753-Hydrawise-API-Information
 
+### v2 API (optional)
+
+v2 is the unofficial GraphQL API used by the Hydrawise app (`app.hydrawise.com/api/v2/graph`). Enable it in instance settings and enter the same email/password as the app. v1 can be disabled independently if you only want GraphQL.
+
+| Object tree | Source | Controls irrigation? |
+| --- | --- | --- |
+| `schedule.*` | v1 REST | yes (`setzone.php`) |
+| `zones.*` | v2 GraphQL | yes (GraphQL mutations), only if v2 is enabled |
+| `water.*`, `sensors.*`, `weather.*`, `controller.*` | v2 GraphQL | read-only |
+| `info.connection` | v1 | — |
+| `info.connectionV2` | v2 | — |
+
+v1 `schedule.sensors.*` only contains sensor *configuration*. Measured flow, rainfall and leak suspicion come from v2 `sensors.*` / `water.leakSuspected`.
+
+Default v2 poll interval is **300 seconds** (minimum 120). GraphQL is rate-limited per account (including the official app). Do not lower this without a reason.
+
+`customerdetails.php` is polled on its own 5-minute timer with backoff after HTTP 429. Commands never call that endpoint.
+
 > **Note**  
 > After updating from 0.0.15 you have to re-enter your API key
 
@@ -39,6 +62,11 @@ You can see all controller information, schedules and sensors. It is also possib
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 2.0.0 (2026-09-02)
+
+* (SentiQ) **NEW**: Optional Hydrawise v2 GraphQL API (water usage, live sensors, weather, leak indicator, zone commands)
+* (SentiQ) **ENHANCED**: customerdetails.php polls on its own 5-minute timer with backoff after rate limits
+
 ### 1.1.0 (2026-09-01)
 
 * (SentiQ) **FIXED**: Relay ID mapping no longer writes onto the Object constructor
@@ -50,7 +78,7 @@ You can see all controller information, schedules and sensors. It is also possib
 ### 1.0.6 (2026-08-09)
 
 - (SentiQ) updated dependencies
-- (copilot) Adapter requires node.js >= 22 now
+- (SentiQ) Adapter requires node.js >= 22 now
 
 ### 1.0.5 (2025-12-05)
 
@@ -62,10 +90,6 @@ You can see all controller information, schedules and sensors. It is also possib
 - (SentiQ) fixed dependencies
 - (SentiQ) fixed schema URLs
 
-### 1.0.3 (2025-12-05)
-
-- (SentiQ) updated dependencies
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License

package/admin/i18n/de.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "API-Intervall (in Sekunden)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "GraphQL nutzen, REST nur als Fallback",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Beide APIs liefern Zonen und Zeitplan. v2 (GraphQL) ist empfohlen: Login wie in der Hydrawise-App, plus Wetter und Sensoren. v1 (REST) ist der Fallback per API-Schlüssel, falls GraphQL nicht geht. Mindestens eine API muss an sein.",
+    "open hydrawise app": "Hydrawise-Dashboard öffnen",
+    "open account details": "Konto / API-Schlüssel",
+    "REST API (fallback)": "REST-API (Fallback)",
+    "GraphQL API (recommended)": "GraphQL-API (empfohlen)",
+    "api interval": "Abfrageintervall",
     "api key": "API-Schlüssel",
-    "how to get token": "So erhalten Sie ein Token"
+    "how to get token": "Schlüssel unter Kontoeinstellungen auf hydrawise.com erzeugen",
+    "Enable v1 API (REST)": "v1-API aktivieren (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Nur nötig, wenn GraphQL nicht verfügbar ist. Dieselben Zonen und Zeitpläne wie v2, ohne Wetter und Sensoren. customerdetails: max. 5 Anfragen / 5 Minuten.",
+    "Enable v2 API (GraphQL)": "v2-API aktivieren (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Dieselbe E-Mail und dasselbe Passwort wie in der Hydrawise-App. Zonen, Zeitplan, plus Sensoren, Wetter und Wasserverbrauch. Nicht öfter als alle 2 Minuten pollen.",
+    "v2 username": "E-Mail",
+    "v2 password": "Passwort",
+    "v2 interval": "Abfrageintervall",
+    "v2 interval help": "Standard 300 s, Minimum 120 s (GraphQL-Limit, geteilt mit der offiziellen App)."
 }

package/admin/i18n/en.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "API interval (in seconds)",
-    "api key": "API-Key",
-    "how to get token": "How to get a token"
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Use GraphQL; REST is a fallback",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.",
+    "open hydrawise app": "Open Hydrawise dashboard",
+    "open account details": "Account / API key",
+    "REST API (fallback)": "REST API (fallback)",
+    "GraphQL API (recommended)": "GraphQL API (recommended)",
+    "api interval": "Poll interval",
+    "api key": "API key",
+    "how to get token": "Generate the key under Account Settings on hydrawise.com",
+    "Enable v1 API (REST)": "Enable v1 API (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.",
+    "Enable v2 API (GraphQL)": "Enable v2 API (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.",
+    "v2 username": "Email",
+    "v2 password": "Password",
+    "v2 interval": "Poll interval",
+    "v2 interval help": "Default 300 s, minimum 120 s (GraphQL rate limits, shared with the official app)."
 }

package/admin/i18n/es.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Intervalo API (en segundos)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Usar GraphQL; REST es el respaldo",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Ambas API ofrecen zonas y programación. v2 (GraphQL) es la recomendada: mismo inicio de sesión que la app Hydrawise, más clima y sensores. v1 (REST) es el respaldo con clave API si GraphQL no está disponible. Debe estar activa al menos una API.",
+    "open hydrawise app": "Abrir el panel de Hydrawise",
+    "open account details": "Cuenta / clave API",
+    "REST API (fallback)": "API REST (respaldo)",
+    "GraphQL API (recommended)": "API GraphQL (recomendada)",
+    "api interval": "Intervalo de consulta",
     "api key": "Clave API",
-    "how to get token": "Como conseguir ficha"
+    "how to get token": "Genere la clave en Ajustes de cuenta en hydrawise.com",
+    "Enable v1 API (REST)": "Activar API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Solo si GraphQL no está disponible. Las mismas zonas y programaciones que v2, sin clima ni sensores. customerdetails: 5 solicitudes / 5 minutos.",
+    "Enable v2 API (GraphQL)": "Activar API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Mismo correo y contraseña que la app Hydrawise. Zonas, programación, más sensores, clima y consumo de agua. No consultar más a menudo que cada 2 minutos.",
+    "v2 username": "Correo",
+    "v2 password": "Contraseña",
+    "v2 interval": "Intervalo de consulta",
+    "v2 interval help": "300 s por defecto, mínimo 120 s (límites GraphQL, compartidos con la app oficial)."
 }

package/admin/i18n/fr.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Intervalle API (en secondes)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Utiliser GraphQL ; REST en secours",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Les deux API fournissent zones et planning. v2 (GraphQL) est recommandée : mêmes identifiants que l’app Hydrawise, plus météo et capteurs. v1 (REST) est le secours via clé API si GraphQL est indisponible. Au moins une API doit être activée.",
+    "open hydrawise app": "Ouvrir le tableau de bord Hydrawise",
+    "open account details": "Compte / clé API",
+    "REST API (fallback)": "API REST (secours)",
+    "GraphQL API (recommended)": "API GraphQL (recommandée)",
+    "api interval": "Intervalle d’interrogation",
     "api key": "Clé API",
-    "how to get token": "Comment obtenir un jeton"
+    "how to get token": "Générez la clé dans les paramètres du compte sur hydrawise.com",
+    "Enable v1 API (REST)": "Activer l’API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Uniquement si GraphQL est indisponible. Mêmes zones et plannings que v2, sans météo ni capteurs. customerdetails : 5 requêtes / 5 minutes.",
+    "Enable v2 API (GraphQL)": "Activer l’API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Même e-mail et mot de passe que l’app Hydrawise. Zones, planning, plus capteurs, météo et consommation d’eau. Pas plus souvent que toutes les 2 minutes.",
+    "v2 username": "E-mail",
+    "v2 password": "Mot de passe",
+    "v2 interval": "Intervalle d’interrogation",
+    "v2 interval help": "300 s par défaut, minimum 120 s (limites GraphQL, partagées avec l’app officielle)."
 }

package/admin/i18n/it.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Intervallo API (in secondi)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Usa GraphQL; REST è il ripiego",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Entrambe le API forniscono zone e programmi. v2 (GraphQL) è consigliata: stesso login dell’app Hydrawise, più meteo e sensori. v1 (REST) è il ripiego con chiave API se GraphQL non è disponibile. Almeno un’API deve essere attiva.",
+    "open hydrawise app": "Apri dashboard Hydrawise",
+    "open account details": "Account / chiave API",
+    "REST API (fallback)": "API REST (ripiego)",
+    "GraphQL API (recommended)": "API GraphQL (consigliata)",
+    "api interval": "Intervallo di polling",
     "api key": "Chiave API",
-    "how to get token": "Come ottenere il gettone"
+    "how to get token": "Genera la chiave in Impostazioni account su hydrawise.com",
+    "Enable v1 API (REST)": "Abilita API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Solo se GraphQL non è disponibile. Stesse zone e programmi di v2, senza meteo né sensori. customerdetails: 5 richieste / 5 minuti.",
+    "Enable v2 API (GraphQL)": "Abilita API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Stessa email e password dell’app Hydrawise. Zone, programmi, più sensori, meteo e consumo idrico. Non interrogare più spesso di ogni 2 minuti.",
+    "v2 username": "Email",
+    "v2 password": "Password",
+    "v2 interval": "Intervallo di polling",
+    "v2 interval help": "Predefinito 300 s, minimo 120 s (limiti GraphQL, condivisi con l’app ufficiale)."
 }

package/admin/i18n/nl.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "API-interval (in seconden)",
-    "api key": "API sleutel",
-    "how to get token": "Hoe een token te verkrijgen"
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "GraphQL gebruiken; REST is fallback",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Beide API’s leveren zones en schema. v2 (GraphQL) is aanbevolen: dezelfde login als de Hydrawise-app, plus weer en sensoren. v1 (REST) is de fallback via API-sleutel als GraphQL niet beschikbaar is. Minstens één API moet aan staan.",
+    "open hydrawise app": "Hydrawise-dashboard openen",
+    "open account details": "Account / API-sleutel",
+    "REST API (fallback)": "REST-API (fallback)",
+    "GraphQL API (recommended)": "GraphQL-API (aanbevolen)",
+    "api interval": "Poll-interval",
+    "api key": "API-sleutel",
+    "how to get token": "Genereer de sleutel onder accountinstellingen op hydrawise.com",
+    "Enable v1 API (REST)": "v1-API inschakelen (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Alleen nodig als GraphQL niet beschikbaar is. Dezelfde zones en schema’s als v2, zonder weer en sensoren. customerdetails: 5 verzoeken / 5 minuten.",
+    "Enable v2 API (GraphQL)": "v2-API inschakelen (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Zelfde e-mail en wachtwoord als de Hydrawise-app. Zones, schema, plus sensoren, weer en waterverbruik. Niet vaker dan elke 2 minuten pollen.",
+    "v2 username": "E-mail",
+    "v2 password": "Wachtwoord",
+    "v2 interval": "Poll-interval",
+    "v2 interval help": "Standaard 300 s, minimum 120 s (GraphQL-limieten, gedeeld met de officiële app)."
 }

package/admin/i18n/pl.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Interwał API (w sekundach)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Używaj GraphQL; REST to zapas",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Oba API dają strefy i harmonogram. v2 (GraphQL) jest zalecane: to samo logowanie co w aplikacji Hydrawise, plus pogoda i czujniki. v1 (REST) to zapas przez klucz API, gdy GraphQL jest niedostępne. Musi być włączone co najmniej jedno API.",
+    "open hydrawise app": "Otwórz pulpit Hydrawise",
+    "open account details": "Konto / klucz API",
+    "REST API (fallback)": "API REST (zapas)",
+    "GraphQL API (recommended)": "API GraphQL (zalecane)",
+    "api interval": "Interwał odpytywania",
     "api key": "Klucz API",
-    "how to get token": "Jak zdobyć token"
+    "how to get token": "Wygeneruj klucz w ustawieniach konta na hydrawise.com",
+    "Enable v1 API (REST)": "Włącz API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Tylko gdy GraphQL jest niedostępne. Te same strefy i harmonogramy co v2, bez pogody i czujników. customerdetails: 5 żądań / 5 minut.",
+    "Enable v2 API (GraphQL)": "Włącz API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Ten sam e-mail i hasło co w aplikacji Hydrawise. Strefy, harmonogram, plus czujniki, pogoda i zużycie wody. Nie odpytywać częściej niż co 2 minuty.",
+    "v2 username": "E-mail",
+    "v2 password": "Hasło",
+    "v2 interval": "Interwał odpytywania",
+    "v2 interval help": "Domyślnie 300 s, minimum 120 s (limity GraphQL, wspólne z oficjalną aplikacją)."
 }

package/admin/i18n/pt.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Intervalo de API (em segundos)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Usar GraphQL; REST é o recurso",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Ambas as APIs fornecem zonas e agenda. v2 (GraphQL) é recomendada: mesmo login da app Hydrawise, mais clima e sensores. v1 (REST) é o recurso via chave API se GraphQL não estiver disponível. Pelo menos uma API tem de estar ligada.",
+    "open hydrawise app": "Abrir painel Hydrawise",
+    "open account details": "Conta / chave API",
+    "REST API (fallback)": "API REST (recurso)",
+    "GraphQL API (recommended)": "API GraphQL (recomendada)",
+    "api interval": "Intervalo de consulta",
     "api key": "Chave API",
-    "how to get token": "Como obter token"
+    "how to get token": "Gere a chave em Definições da conta em hydrawise.com",
+    "Enable v1 API (REST)": "Ativar API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Só necessário se GraphQL estiver indisponível. As mesmas zonas e agendas que v2, sem clima nem sensores. customerdetails: 5 pedidos / 5 minutos.",
+    "Enable v2 API (GraphQL)": "Ativar API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Mesmo e-mail e senha da app Hydrawise. Zonas, agenda, mais sensores, clima e consumo de água. Não consultar mais do que a cada 2 minutos.",
+    "v2 username": "E-mail",
+    "v2 password": "Senha",
+    "v2 interval": "Intervalo de consulta",
+    "v2 interval help": "Padrão 300 s, mínimo 120 s (limites GraphQL, partilhados com o app oficial)."
 }

package/admin/i18n/ru.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Интервал API (в секундах)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Используйте GraphQL; REST — запасной вариант",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Оба API дают зоны и расписание. v2 (GraphQL) рекомендуется: тот же вход, что в приложении Hydrawise, плюс погода и датчики. v1 (REST) — запасной вариант по API-ключу, если GraphQL недоступен. Должен быть включён хотя бы один API.",
+    "open hydrawise app": "Открыть панель Hydrawise",
+    "open account details": "Аккаунт / API-ключ",
+    "REST API (fallback)": "REST API (запасной)",
+    "GraphQL API (recommended)": "GraphQL API (рекомендуется)",
+    "api interval": "Интервал опроса",
     "api key": "API-ключ",
-    "how to get token": "Как получить токен"
+    "how to get token": "Создайте ключ в настройках аккаунта на hydrawise.com",
+    "Enable v1 API (REST)": "Включить API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Только если GraphQL недоступен. Те же зоны и расписания, что у v2, без погоды и датчиков. customerdetails: 5 запросов / 5 минут.",
+    "Enable v2 API (GraphQL)": "Включить API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Тот же email и пароль, что в приложении Hydrawise. Зоны, расписание, плюс датчики, погода и расход воды. Не опрашивать чаще чем раз в 2 минуты.",
+    "v2 username": "Email",
+    "v2 password": "Пароль",
+    "v2 interval": "Интервал опроса",
+    "v2 interval help": "По умолчанию 300 с, минимум 120 с (лимиты GraphQL, общие с официальным приложением)."
 }

package/admin/i18n/uk.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "Інтервал API (у секундах)",
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "Використовуйте GraphQL; REST — запасний варіант",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "Обидва API дають зони й розклад. v2 (GraphQL) рекомендовано: той самий вхід, що в програмі Hydrawise, плюс погода й датчики. v1 (REST) — запасний варіант за API-ключем, якщо GraphQL недоступний. Має бути ввімкнено принаймні один API.",
+    "open hydrawise app": "Відкрити панель Hydrawise",
+    "open account details": "Обліковий запис / API-ключ",
+    "REST API (fallback)": "REST API (запасний)",
+    "GraphQL API (recommended)": "GraphQL API (рекомендовано)",
+    "api interval": "Інтервал опитування",
     "api key": "API-ключ",
-    "how to get token": "Як отримати токен"
+    "how to get token": "Створіть ключ у параметрах облікового запису на hydrawise.com",
+    "Enable v1 API (REST)": "Увімкнути API v1 (REST)",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "Лише якщо GraphQL недоступний. Ті самі зони й розклади, що у v2, без погоди й датчиків. customerdetails: 5 запитів / 5 хвилин.",
+    "Enable v2 API (GraphQL)": "Увімкнути API v2 (GraphQL)",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "Той самий email і пароль, що в програмі Hydrawise. Зони, розклад, плюс датчики, погода й витрата води. Не опитувати частіше ніж раз на 2 хвилини.",
+    "v2 username": "Email",
+    "v2 password": "Пароль",
+    "v2 interval": "Інтервал опитування",
+    "v2 interval help": "За замовчуванням 300 с, мінімум 120 с (ліміти GraphQL, спільні з офіційною програмою)."
 }

package/admin/i18n/zh-cn.json

@@ -1,5 +1,22 @@
 {
-    "api interval": "API 间隔（以秒为单位）",
-    "api key": "API密钥",
-    "how to get token": "如何获取代币"
+    "Home": "Home",
+    "v1 API": "v1 API",
+    "v2 API": "v2 API",
+    "Use GraphQL; REST is a fallback": "使用 GraphQL；REST 仅作备用",
+    "Both APIs provide zones and schedules. v2 (GraphQL) is recommended: same login as the Hydrawise app, plus weather and sensors. v1 (REST) is a fallback via API key if GraphQL is unavailable. At least one API must be on.": "两个 API 都提供区域和计划。推荐 v2（GraphQL）：与 Hydrawise 应用相同的登录，另加天气和传感器。v1（REST）是 GraphQL 不可用时通过 API 密钥的备用方案。至少启用一个 API。",
+    "open hydrawise app": "打开 Hydrawise 仪表板",
+    "open account details": "账户 / API 密钥",
+    "REST API (fallback)": "REST API（备用）",
+    "GraphQL API (recommended)": "GraphQL API（推荐）",
+    "api interval": "轮询间隔",
+    "api key": "API 密钥",
+    "how to get token": "在 hydrawise.com 的账户设置中生成密钥",
+    "Enable v1 API (REST)": "启用 v1 API（REST）",
+    "Only needed if GraphQL is unavailable. Same zones and schedules as v2, without weather and sensors. customerdetails is limited to 5 requests / 5 minutes.": "仅在 GraphQL 不可用时需要。与 v2 相同的区域和计划，不含天气和传感器。customerdetails：5 次 / 5 分钟。",
+    "Enable v2 API (GraphQL)": "启用 v2 API（GraphQL）",
+    "Same email and password as the Hydrawise app. Zones, schedules, plus sensors, weather and water use. Do not poll faster than every 2 minutes.": "与 Hydrawise 应用相同的邮箱和密码。区域、计划，另加传感器、天气和用水量。轮询间隔不要短于 2 分钟。",
+    "v2 username": "邮箱",
+    "v2 password": "密码",
+    "v2 interval": "轮询间隔",
+    "v2 interval help": "默认 300 秒，最小 120 秒（GraphQL 限速，与官方应用共享）。"
 }