Modify a Talq Device

PATCH

/talq/devices

Partially updates a list of devices. This operation can just update and add new functions/attribute values to the device, but it does not reduce its scope

Request

Query Params

Body Params application/json

Example

[
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    },
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request PATCH 'https://iot.exati.com.br/talq/devices?clientAddress={{gateway-uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    },
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    }
]'

Responses

🟢200OK

application/json

The list of device is successfully updated

Body

Example

[
    {
        "address": "string",
        "name": "string",
        "class": "string",
        "functions": [
            {
                "id": "string",
                "type": "BasicFunction"
            }
        ]
    }
]

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠409409

🟠422Parameter Error

Modified at 2025-07-30 16:35:39

List Talq Devices

Update Talq Devices