IotHub
  1. Bootstrap process
IotHub
  • API
    • TALQ
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Create a Talq Device
        • List Talq Devices
        • Modify a Talq Device
        • Update Talq Devices
        • Delete a Talq Device
        • Get a Talq Device
        • Modify a Talq Device patch
        • Update a Talq Device
        • Get a Talq Device Function
        • Get a Talq Device Attribute
      • Services
        • Create a Talq Service
      • Group
        • List Talq Groups
        • Get a Talq Group
  • Docs TALQ
    • Introdução à especificação TALQ
    • Visão geral da API TALQ
    • Bootstrap process
    • Tier 1
      • Visão Geral
      • Solicitações
        • Criar Solicitação
        • Cancelar Solicitação
    • Tier 2
      • Visão geral
      • Bootstrap process
        • Device discovery
          POST
        • Classes discovery
          POST
        • Services announcement
          POST
        • Gateway update
          PATCH
        • Gateway class announcement
          POST
        • Gateway announcement
          POST
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Get a Talq Device
        • Create a Talq Device
        • List Talq Devices
        • Modify a Talq Device
        • Update Talq Devices
        • Delete a Talq Device
        • Modify a Talq Device patch
        • Update a Talq Device
        • Get a Talq Device Function
        • Get a Talq Device Attribute
    • Tier 3
      • Visão Geral
      • Group
        • List Talq Groups
        • Get a Talq Group
      • Logger Configs
        • Get Logger Config
      • Log Reports
        • Send log report
    • Tier 4
      • Visão Geral
  1. Bootstrap process

Device discovery

Developing
POST
/talq/devices

Request

Query Params

Body Params application/json

Example
[
    {
        "address": "{{$string.uuid}}",
        "name": "{{$commerce.productAdjective}} {{$commerce.productName}}",
        "class": "cls:AllAttributes4Functions",
        "functions": [
            {
                "id": "fLuminaireAssetFunction",
                "type": "LuminaireAssetFunction"
            },
            {
                "id": "fLampMonitorFunction",
                "type": "LampMonitorFunction"
            },
            {
                "id": "fCommunicationFunction",
                "type": "CommunicationFunction"
            },
            {
                "id": "fBasicFunction",
                "type": "BasicFunction",
                "Binary": {"type": "AttributeBinary",
                "value": "ON"},
                "Boolean": {"type": "AttributeBoolean"},
                "BooleanState": {
                    "type": "AttributeBooleanState",
                    "value": {
                        "name": "BooleanState",
                        "value": true
                    }
                },
                "CabinetActuatingType": {"type": "AttributeCabinetActuatingType"},
                "CabinetSegmentsConfiguration": {
                    "type": "AttributeCabinetSegmentsConfiguration",
                    "value": [
                        {
                            "level": 1,
                            "segmentMonitors": [
                                {
                                    "segmentMonitorFunctionId": "123",
                                    "relayState": "OFF"
                                }
                            ]
                        },
                        {
                            "level": 100,
                            "segmentMonitors": []
                        }
                    ]
                },
                "CCTColorState": {"type": "AttributeCCTColorState"},
                "Command": {
                    "type": "AttributeCommand",
                    "value": {
                        "state": {
                            "name": "LevelState",
                            "value": 50
                        }
                    }
                },
                "ContentsType": {"type": "AttributeContentsType"},
                "DateTime": {"type": "AttributeDateTime"},
                "FactorSense": {"type": "AttributeFactorSense"},
                "Float": {"type": "AttributeFloat"},
                "FloatKVPArray": {"type": "AttributeFloatKVPArray"},
                "FloatState": {"type": "AttributeFloatState"},
                "GasName": {"type": "AttributeGasName"},
                "Integer": {"type": "AttributeInteger"},
                "IntegerState": {"type": "AttributeIntegerState"},
                "LevelAndCCTColorState": {"type": "AttributeLevelAndCCTColorState"},
                "LevelAndRGBWAFColorState": {"type": "AttributeLevelAndRGBWAFColorState"},
                "LevelAndXYColorState": {"type": "AttributeLevelAndXYColorState"},
                "LevelState": {"type": "AttributeLevelState"},
                "LocalOverride": {"type": "AttributeLocalOverride"},
                "Location": {"type": "AttributeLocation"},
                "LuminaireConnectionType": {"type": "AttributeLuminaireConnectionType"},
                "MountingOption": {"type": "AttributeMountingOption"},
                "Orientation": {"type": "AttributeOrientation"},
                "ParkingSlotDataArray": {"type": "AttributeParkingSlotDataArray"},
                "ParkingSlotOccupancyStatus": {"type": "AttributeParkingSlotOccupancyStatus"},
                "Percent": {"type": "AttributePercent"},
                "PositionedTextState": {"type": "AttributePositionedTextState"},
                "PowerSource": {"type": "AttributePowerSource"},
                "RGBState": {"type": "AttributeRGBState"},
                "RGBWAFColorState": {"type": "AttributeRGBWAFColorState"},
                "RoadUser": {"type": "AttributeRoadUser"},
                "String": {"type": "AttributeString"},
                "StringArray": {"type": "AttributeStringArray"},
                "SupplyType": {"type": "AttributeSupplyType"},
                "TextState": {"type": "AttributeTextState"},
                "TrafficDirection": {"type": "AttributeTrafficDirection"},
                "Uri": {
                    "type": "AttributeUri",
                    "value": "https://google.com"
                },
                "Velocity": {
                    "type": "AttributeVelocity",
                    "value": {
                        "horizontalVelocity": {
                            "horizontalSpeed": 1,
                            "bearing": 1
                        }
                    }
                },
                "WindDirection": {"type": "AttributeWindDirection", "value": "N"},
                "XYColorState": {
                    "type": "AttributeXYColorState", 
                    "value": {
               

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://iot.exati.com.br/staging/talq/devices?clientAddress=' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "address": "{{$string.uuid}}",
        "name": "{{$commerce.productAdjective}} {{$commerce.productName}}",
        "class": "cls:AllAttributes4Functions",
        "functions": [
            {
                "id": "fLuminaireAssetFunction",
                "type": "LuminaireAssetFunction"
            },
            {
                "id": "fLampMonitorFunction",
                "type": "LampMonitorFunction"
            },
            {
                "id": "fCommunicationFunction",
                "type": "CommunicationFunction"
            },
            {
                "id": "fBasicFunction",
                "type": "BasicFunction",
                "Binary": {"type": "AttributeBinary",
                "value": "ON"},
                "Boolean": {"type": "AttributeBoolean"},
                "BooleanState": {
                    "type": "AttributeBooleanState",
                    "value": {
                        "name": "BooleanState",
                        "value": true
                    }
                },
                "CabinetActuatingType": {"type": "AttributeCabinetActuatingType"},
                "CabinetSegmentsConfiguration": {
                    "type": "AttributeCabinetSegmentsConfiguration",
                    "value": [
                        {
                            "level": 1,
                            "segmentMonitors": [
                                {
                                    "segmentMonitorFunctionId": "123",
                                    "relayState": "OFF"
                                }
                            ]
                        },
                        {
                            "level": 100,
                            "segmentMonitors": []
                        }
                    ]
                },
                "CCTColorState": {"type": "AttributeCCTColorState"},
                "Command": {
                    "type": "AttributeCommand",
                    "value": {
                        "state": {
                            "name": "LevelState",
                            "value": 50
                        }
                    }
                },
                "ContentsType": {"type": "AttributeContentsType"},
                "DateTime": {"type": "AttributeDateTime"},
                "FactorSense": {"type": "AttributeFactorSense"},
                "Float": {"type": "AttributeFloat"},
                "FloatKVPArray": {"type": "AttributeFloatKVPArray"},
                "FloatState": {"type": "AttributeFloatState"},
                "GasName": {"type": "AttributeGasName"},
                "Integer": {"type": "AttributeInteger"},
                "IntegerState": {"type": "AttributeIntegerState"},
                "LevelAndCCTColorState": {"type": "AttributeLevelAndCCTColorState"},
                "LevelAndRGBWAFColorState": {"type": "AttributeLevelAndRGBWAFColorState"},
                "LevelAndXYColorState": {"type": "AttributeLevelAndXYColorState"},
                "LevelState": {"type": "AttributeLevelState"},
                "LocalOverride": {"type": "AttributeLocalOverride"},
                "Location": {"type": "AttributeLocation"},
                "LuminaireConnectionType": {"type": "AttributeLuminaireConnectionType"},
                "MountingOption": {"type": "AttributeMountingOption"},
                "Orientation": {"type": "AttributeOrientation"},
                "ParkingSlotDataArray": {"type": "AttributeParkingSlotDataArray"},
                "ParkingSlotOccupancyStatus": {"type": "AttributeParkingSlotOccupancyStatus"},
                "Percent": {"type": "AttributePercent"},
                "PositionedTextState": {"type": "AttributePositionedTextState"},
                "PowerSource": {"type": "AttributePowerSource"},
                "RGBState": {"type": "AttributeRGBState"},
                "RGBWAFColorState": {"type": "AttributeRGBWAFColorState"},
                "RoadUser": {"type": "AttributeRoadUser"},
                "String": {"type": "AttributeString"},
                "StringArray": {"type": "AttributeStringArray"},
                "SupplyType": {"type": "AttributeSupplyType"},
                "TextState": {"type": "AttributeTextState"},
                "TrafficDirection": {"type": "AttributeTrafficDirection"},
                "Uri": {
                    "type": "AttributeUri",
                    "value": "https://google.com"
                },
                "Velocity": {
                    "type": "AttributeVelocity",
                    "value": {
                        "horizontalVelocity": {
                            "horizontalSpeed": 1,
                            "bearing": 1
                        }
                    }
                },
                "WindDirection": {"type": "AttributeWindDirect

Responses

🟢200Success
application/json
Body

Example
{}
Modified at 2025-09-11 13:03:54
Previous
Visão geral
Next
Classes discovery