release v2.2025.02.02.0

Author: kristel030

tado-api-test/src/test/kotlin/tadoclient/apis/BridgeApi_IT.kt

@@ -0,0 +1,52 @@
+package tadoclient.apis
+
+import org.junit.jupiter.api.*
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.beans.factory.annotation.Qualifier
+import org.junit.jupiter.api.condition.EnabledIf
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.web.client.RestClient
+import tadoclient.Application
+import tadoclient.TadoConfig
+import tadoclient.verify.assertCorrectResponse
+import tadoclient.verify.verifyHeatingCircuit
+import tadoclient.verify.verifyZoneControl
+import kotlin.test.assertNotEquals
+
+@SpringBootTest(classes = arrayOf( Application::class))
+@TestMethodOrder(MethodOrderer.OrderAnnotation::class)
+@DisplayName("tado API - heating circuit")
+class HeatingCircuitAPI_IT(
+    @Qualifier("tadoStrictRestClient")
+    val tadoStrictRestClient: RestClient,
+
+    @Autowired
+    tadoConfig: TadoConfig
+): BaseTest(tadoConfig) {
+    val tadoStrictHeatingCircuitApiAPI = HeatingCircuitApi(tadoStrictRestClient)
+
+    @Test
+    @DisplayName("GET /homes/{homeId}/heatingCircuits")
+    @Order(10)
+    @EnabledIf(value = "isHomeConfigured", disabledReason = "no home specified in tado set-up")
+    fun getHeatingCircuits() {
+        val endpoint = "GET /homes/{homeId}/heatingCircuits"
+        val heatingCircuits = assertCorrectResponse { tadoStrictHeatingCircuitApiAPI.getHeatingCircuits(tadoConfig.home!!.id) }
+        assertNotEquals(0, heatingCircuits.size)
+        heatingCircuits.forEachIndexed {i, elem -> verifyHeatingCircuit(elem, "$endpoint[$i]") }
+    }
+
+    // Integration test for GET /homes/{homeId}/zones/{zoneId}/control
+    // see DeviceApi_IT
+    // (the operation belongs to multiple API operation groups, and the 'device' group is considered to be the primary one)
+
+    @Test
+    @DisplayName("GET /homes/{homeId}/zones/{zoneId}/control/heatingCircuit")
+    @Order(20)
+    @EnabledIf(value = "isHeatingZoneConfigured", disabledReason = "no home specified in tado set-up")
+    fun setHeatingCircuitForZone() {
+        val endpoint = "PUT /homes/{homeId}/zones/{zoneId}/control/heatingCircuit"
+        val zoneControl = assertCorrectResponse { tadoStrictHeatingCircuitApiAPI.setHeatingCircuit(tadoConfig.home!!.id, tadoConfig.zone!!.heating!!.id) }
+        verifyZoneControl(zoneControl, endpoint) }
+    }
+}

tado-api-test/src/test/kotlin/tadoclient/apis/HomeByBridgeApi_IT.kt

@@ -0,0 +1,4 @@
+package tadoclient.apis
+
+class HomeByBridgeAPI_IT {
+}

tado-openapispec-v2.yaml

@@ -31,7 +31,7 @@ info:
     [https://github.com/kritsel/tado-openapispec-v2](https://github.com/kritsel/tado-openapispec-v2)
     * Wiki for this GitHub repo with additional information:
     [https://github.com/kritsel/tado-openapispec-v2/wiki](https://github.com/kritsel/tado-openapispec-v2/wiki/)
-  version: 2.2025.01.27.1
+  version: 2.2025.02.02.0
 servers:
   - url: https://my.tado.com/api/v2/
 security:
@@ -2230,6 +2230,19 @@ paths:
           schema:
             $ref: '#/components/schemas/DeviceId'
           required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ChildLock'
+            examples:
+              celsius:
+                value:
+                  celsius: 1.75
+              fahrenheit:
+                value:
+                  fahrenheit: -2.25
       responses:
         '204':
           description: successful response
@@ -2701,8 +2714,12 @@ paths:
                 serialNo:
                   $ref: '#/components/schemas/DeviceId'
       responses:
-        '204':
+        '200':
           description: successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Device'
         '401':
           $ref: '#/components/responses/Unauthorized401'
         '403':
@@ -3108,6 +3125,14 @@ components:
       example: LOW
       description: element of DayReport
 
+    ChildLock:
+      type: object
+      description: input for PUT /devices/{deviceId}/childLock
+      properties:
+        childLockEnabled:
+          type: boolean
+          example: false
+
     # DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
     DataInterval:
       type: object
@@ -4187,6 +4212,8 @@ components:
                      * OPEN_WINDOW_DETECTED
                     
                      * OVERLAY_ACTIVE
+                    
+                     * MEASURING_DEVICE_DISCONNECTED
                 setting:
                   $ref: '#/components/schemas/ZoneSetting'