Description

Creates a new smart device at a specific service location:

General information
Configuration properties

Resource URL

https://app1pub.smappee.net/dev/v3/servicelocation/[SERVICELOCATIONID]/smartdevices

HTTP method

POST

HTTP header

Authorization: Bearer [ACCESS_TOKEN]

[ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.

Parameters

Parameter	Type	Description
SERVICELOCATIONID	Path Parameter	The actual id of an accessible service location (see Get Servicelocations)

HTTP body

{
  "category": "CARCHARGER",
  "name": "Example",
  "favourite": true,
  "typeName": "greenflux",
  "configurationProperties": [
    {
      "value": {
        "unit": "A",
        "value": 10
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.power.threshold"
      }
    },
    {
      "value": "mqtt://app1pub.smappee.net/just/an/example",
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.mqtt.url"
      }
    },
    {
      "value": {
        "unit": "s",
        "value": 300
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.slow.message.frequency"
      }
    },
    {
      "value": {
        "unit": "s",
        "value": 5
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.fast.message.frequency"
      }
    }
  ]
}

Example

https://app1pub.smappee.net/dev/v3/servicelocation/123/smartdevices

Result

{
  "id": "CARCHARGER-1",
  "uuid": "34dd94f0-e186-43d0-b7c2-cdf59fb9855f",
  "name": "Example",
  "favourite": true,
  "type": {
    "category": "CARCHARGER",
    "name": "greenflux",
    "displayName": "GreenFlux",
    "logoURL": "https://smappeelogos.s3-eu-west-1.amazonaws.com/greenflux/GreenFluxLogo.png",
    "protocol": "MQTT",
    "configurationProperties": [
      {
        "name": "etc.smart.device.type.car.charger.config.greenflux.power.threshold",
        "displayName": "Power threshold",
        "description": "When this threshold is exceeded on one of the phases the fast message frequency is used to send measurement messages to the MQTT Broker.",
        "species": "Quantity",
        "unit": "A",
        "required": true
      },
      {
        "name": "etc.smart.device.type.car.charger.config.greenflux.mqtt.url",
        "displayName": "MQTT Broker url",
        "description": "Measurements messages are published on this MQTT Broker. Specify as host:port. When not specified the Smappee MQTT production broker is used.",
        "species": "String",
        "required": false
      },
      {
        "name": "etc.smart.device.type.car.charger.config.greenflux.fast.message.frequency",
        "displayName": "Fast message frequency",
        "description": "Fast message frequency is an optional parameter, default is 5 seconds.",
        "species": "Quantity",
        "unit": "s",
        "required": false,
        "possibleValues": {
          "values": [
            {
              "value": 5,
              "unit": "s"
            }
          ],
          "defaultValue": {
            "unit": "SECOND",
            "value": 5,
            "multiplier": 0
          },
          "exhaustive": false
        }
      },
      {
        "name": "etc.smart.device.type.car.charger.config.greenflux.slow.message.frequency",
        "displayName": "Slow message frequency",
        "description": "Slow message frequency is an optional parameter, default is 60 seconds.",
        "species": "Quantity",
        "unit": "s",
        "required": false,
        "possibleValues": {
          "values": [
            {
              "value": 60,
              "unit": "s"
            }
          ],
          "defaultValue": {
            "unit": "SECOND",
            "value": 60,
            "multiplier": 0
          },
          "exhaustive": false
        }
      }
    ],
    "properties": [
      {
        "name": "current",
        "displayName": "Consumption car charging station",
        "description": "The power that the car charging station is currently using.",
        "species": "Quantity",
        "unit": "W",
        "required": false
      }
    ],
    "actions": []
  },
  "configurationProperties": [
    {
      "value": {
        "value": 10,
        "unit": "A"
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.power.threshold",
        "displayName": "Power threshold",
        "description": "When this threshold is exceeded on one of the phases the fast message frequency is used to send measurement messages to the MQTT Broker.",
        "species": "Quantity",
        "unit": "A",
        "required": true
      }
    },
    {
      "value": "mqtt://app1pub.smappee.net/just/an/example",
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.mqtt.url",
        "displayName": "MQTT Broker url",
        "description": "MQTT Broker url is an optional parameter, but when specified measurements messages are published on this MQTT Broker. Specify as host:port",
        "species": "String",
        "required": false
      }
    },
    {
      "value": {
        "value": 5,
        "unit": "s"
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.fast.message.frequency",
        "displayName": "Fast message frequency",
        "description": "Fast message frequency is an optional parameter, default is 5 seconds.",
        "species": "Quantity",
        "unit": "s",
        "required": false,
        "possibleValues": {
          "values": [
            {
              "value": 5,
              "unit": "s"
            }
          ],
          "defaultValue": {
            "unit": "SECOND",
            "value": 5,
            "multiplier": 0
          },
          "exhaustive": false
        }
      }
    },
    {
      "value": {
        "value": 300,
        "unit": "s"
      },
      "spec": {
        "name": "etc.smart.device.type.car.charger.config.greenflux.slow.message.frequency",
        "displayName": "Slow message frequency",
        "description": "Slow message frequency is an optional parameter, default is 60 seconds.",
        "species": "Quantity",
        "unit": "s",
        "required": false,
        "possibleValues": {
          "values": [
            {
              "value": 60,
              "unit": "s"
            }
          ],
          "defaultValue": {
            "unit": "SECOND",
            "value": 60,
            "multiplier": 0
          },
          "exhaustive": false
        }
      }
    }
  ]
}

Versioning

Version 3 (v3)

This call was introduced in version 3.

Content

Smappee API

Create a Smart Device