Devices

Creates or updates a Device or updates it's values.

Creates or updates a Device or updates it's values. For a new device leave the ID empty. To create a device you have to set the DeviceEnergyType. To update values, add the ID of the device and the values you like to set. (See the Data Type Model for more Information)

post/Devices

Request

  • Base URL: https://api.smart-me.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.smart-me.com/Devices
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token; client credentials, token URL /oauth/token)
    • HTTP basic

Request body

activePowernumber double nullable

The Active Power or current flow rate. In kW or m3/h

counterReadingnumber double nullable

The Meter Counter Reading (Total Energy used) in kWh or m3.

counterReadingT1number double nullable

The Meter Counter Reading Tariff 1 in kWh or m3.

counterReadingT2number double nullable

The Meter Counter Reading Tariff 2 in kWh or m3.

counterReadingExportnumber double nullable

The Meter Counter Reading only export

counterReadingExportT1number double nullable

The Meter Counter Reading only export (Tariff 1)

counterReadingExportT2number double nullable

The Meter Counter Reading only export (Tariff 2)

temperaturenumber double nullable

The Temperature (in degree celsius)

valueDatestring date-time nullable

The Date of the Value (in UTC). If this is null the Server Time is used.

voltagenumber double nullable

The Voltage (in V)

voltageL1number double nullable

The Voltage Phase L1 (in V)

voltageL2number double nullable

The Voltage Phase L2 (in V)

voltageL3number double nullable

The Voltage Phase L3 (in V)

currentnumber double nullable

The Current (in A)

currentL1number double nullable

The Current Phase L1 (in A)

currentL2number double nullable

The Current Phase L2 (in A)

currentL3number double nullable

The Current Phase L3 (in A)

powerFactornumber double nullable

The Power Factor (cos phi). Range: 0 - 1

powerFactorL1number double nullable

The Power Factor (cos phi) Phase L1. Range: 0 - 1

powerFactorL2number double nullable

The Power Factor (cos phi) Phase L2. Range: 0 - 1

powerFactorL3number double nullable

The Power Factor (cos phi) Phase L3. Range: 0 - 1

digitalInput1boolean nullable

The digital input number 1

idstring uuid

The ID of the device

namestring nullable

The Name of the Device

serialinteger

The Serial number

deviceEnergyType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13
<p>Members: </p><ul><li><i>0</i> - MeterTypeUnknown</li><li><i>1</i> - MeterTypeElectricity</li><li><i>2</i> - MeterTypeWater</li><li><i>3</i> - MeterTypeGas</li><li><i>4</i> - MeterTypeHeat</li><li><i>5</i> - MeterTypeHCA</li><li><i>6</i> - MeterTypeAllMeters</li><li><i>7</i> - MeterTypeTemperature</li><li><i>8</i> - MeterTypeMBusGateway</li><li><i>9</i> - MeterTypeRS485Gateway</li><li><i>10</i> - MeterTypeCustomDevice</li><li><i>11</i> - MeterTypeCompressedAir</li><li><i>12</i> - MeterTypeSolarLog</li><li><i>13</i> - MeterTypeVirtualMeter</li></ul>
meterSubType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
<p>Members: </p><ul><li><i>0</i> - MeterSubTypeUnknown</li><li><i>1</i> - Cold / Cold Water Meter</li><li><i>2</i> - Heat / Hot Water Meter</li><li><i>3</i> - MeterSubTypeChargingStation</li><li><i>4</i> - MeterSubTypeElectricity</li><li><i>5</i> - MeterSubTypeWater</li><li><i>6</i> - MeterSubTypeGas</li><li><i>7</i> - Electricity / Heat meter</li><li><i>8</i> - A Temperature meter</li><li><i>9</i> - MeterSubTypeVirtualBattery</li></ul>

Response

OK

activePowernumber double nullable

The Active Power or current flow rate. In kW or m3/h

counterReadingnumber double nullable

The Meter Counter Reading (Total Energy used) in kWh or m3.

counterReadingT1number double nullable

The Meter Counter Reading Tariff 1 in kWh or m3.

counterReadingT2number double nullable

The Meter Counter Reading Tariff 2 in kWh or m3.

counterReadingExportnumber double nullable

The Meter Counter Reading only export

counterReadingExportT1number double nullable

The Meter Counter Reading only export (Tariff 1)

counterReadingExportT2number double nullable

The Meter Counter Reading only export (Tariff 2)

temperaturenumber double nullable

The Temperature (in degree celsius)

valueDatestring date-time nullable

The Date of the Value (in UTC). If this is null the Server Time is used.

voltagenumber double nullable

The Voltage (in V)

voltageL1number double nullable

The Voltage Phase L1 (in V)

voltageL2number double nullable

The Voltage Phase L2 (in V)

voltageL3number double nullable

The Voltage Phase L3 (in V)

currentnumber double nullable

The Current (in A)

currentL1number double nullable

The Current Phase L1 (in A)

currentL2number double nullable

The Current Phase L2 (in A)

currentL3number double nullable

The Current Phase L3 (in A)

powerFactornumber double nullable

The Power Factor (cos phi). Range: 0 - 1

powerFactorL1number double nullable

The Power Factor (cos phi) Phase L1. Range: 0 - 1

powerFactorL2number double nullable

The Power Factor (cos phi) Phase L2. Range: 0 - 1

powerFactorL3number double nullable

The Power Factor (cos phi) Phase L3. Range: 0 - 1

digitalInput1boolean nullable

The digital input number 1

idstring uuid

The ID of the device

namestring nullable

The Name of the Device

serialinteger

The Serial number

deviceEnergyType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13
<p>Members: </p><ul><li><i>0</i> - MeterTypeUnknown</li><li><i>1</i> - MeterTypeElectricity</li><li><i>2</i> - MeterTypeWater</li><li><i>3</i> - MeterTypeGas</li><li><i>4</i> - MeterTypeHeat</li><li><i>5</i> - MeterTypeHCA</li><li><i>6</i> - MeterTypeAllMeters</li><li><i>7</i> - MeterTypeTemperature</li><li><i>8</i> - MeterTypeMBusGateway</li><li><i>9</i> - MeterTypeRS485Gateway</li><li><i>10</i> - MeterTypeCustomDevice</li><li><i>11</i> - MeterTypeCompressedAir</li><li><i>12</i> - MeterTypeSolarLog</li><li><i>13</i> - MeterTypeVirtualMeter</li></ul>
meterSubType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
<p>Members: </p><ul><li><i>0</i> - MeterSubTypeUnknown</li><li><i>1</i> - Cold / Cold Water Meter</li><li><i>2</i> - Heat / Hot Water Meter</li><li><i>3</i> - MeterSubTypeChargingStation</li><li><i>4</i> - MeterSubTypeElectricity</li><li><i>5</i> - MeterSubTypeWater</li><li><i>6</i> - MeterSubTypeGas</li><li><i>7</i> - Electricity / Heat meter</li><li><i>8</i> - A Temperature meter</li><li><i>9</i> - MeterSubTypeVirtualBattery</li></ul>

Changes

No recorded changes to this operation across all 1 revision of this API.