action smart_me_devices_post { label: "Creates or updates a Device or updates it's values." description: "Creates or updates a Device or updates it's values. \n For a new device leave the ID empty. To create a device you have to set the DeviceEnergyType. \n To update values, add the ID of the device and the values you like to set. (See the Data Type Model for more Information)" provider: smart_me method: POST path: "/api/Devices" encoding: form input: { type: "object" description: "Container Class for the Web API" properties: { ActivePower: { type: "number" format: "double" description: "The Active Power or current flow rate. In kW or m3/h" } CounterReading: { type: "number" format: "double" description: "The Meter Counter Reading (Total Energy used) in kWh or m3." } CounterReadingExport: { type: "number" format: "double" description: "The Meter Counter Reading only export" } CounterReadingExportT1: { type: "number" format: "double" description: "The Meter Counter Reading only export (Tariff 1)" } CounterReadingExportT2: { type: "number" format: "double" description: "The Meter Counter Reading only export (Tariff 2)" } CounterReadingT1: { type: "number" format: "double" description: "The Meter Counter Reading Tariff 1 in kWh or m3." } CounterReadingT2: { type: "number" format: "double" description: "The Meter Counter Reading Tariff 2 in kWh or m3." } Current: { type: "number" format: "double" description: "The Current (in A)" } CurrentL1: { type: "number" format: "double" description: "The Current Phase L1 (in A)" } CurrentL2: { type: "number" format: "double" description: "The Current Phase L2 (in A)" } CurrentL3: { type: "number" format: "double" description: "The Current Phase L3 (in A)" } DeviceEnergyType: { type: "string" description: "The Energy Type of this device" enum: ["MeterTypeUnknown", "MeterTypeElectricity", "MeterTypeWater", "MeterTypeGas", "MeterTypeHeat", "MeterTypeHCA", "MeterTypeAllMeters", "MeterTypeTemperature", "MeterTypeMBusGateway", "MeterTypeRS485Gateway", "MeterTypeCustomDevice", "MeterTypeCompressedAir", "MeterTypeSolarLog", "MeterTypeVirtualMeter", "MeterTypeWMBusGateway"] } DigitalInput1: { type: "boolean" description: "The digital input number 1" } Id: { type: "string" description: "The ID of the device" } MeterSubType: { type: "string" description: "The Sub Type of this Meter." enum: ["MeterSubTypeUnknown", "MeterSubTypeCold", "MeterSubTypeHeat", "MeterSubTypeChargingStation", "MeterSubTypeElectricity", "MeterSubTypeWater", "MeterSubTypeGas", "MeterSubTypeElectricityHeat", "MeterSubTypeTemperature", "MeterSubTypeVirtualBattery"] } Name: { type: "string" description: "The Name of the Device" } PowerFactor: { type: "number" format: "double" description: "The Power Factor (cos phi). Range: 0 - 1" } PowerFactorL1: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L1. Range: 0 - 1" } PowerFactorL2: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L2. Range: 0 - 1" } PowerFactorL3: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L3. Range: 0 - 1" } Serial: { type: "integer" format: "int64" description: "The Serial number" } Temperature: { type: "number" format: "double" description: "The Temperature (in degree celsius)" } ValueDate: { type: "string" format: "date-time" description: "The Date of the Value (in UTC). If this is null the Server Time is used." } Voltage: { type: "number" format: "double" description: "The Voltage (in V)" } VoltageL1: { type: "number" format: "double" description: "The Voltage Phase L1 (in V)" } VoltageL2: { type: "number" format: "double" description: "The Voltage Phase L2 (in V)" } VoltageL3: { type: "number" format: "double" description: "The Voltage Phase L3 (in V)" } } } output: { type: "object" description: "Container Class for the Web API" properties: { ActivePower: { type: "number" format: "double" description: "The Active Power or current flow rate. In kW or m3/h" } CounterReading: { type: "number" format: "double" description: "The Meter Counter Reading (Total Energy used) in kWh or m3." } CounterReadingExport: { type: "number" format: "double" description: "The Meter Counter Reading only export" } CounterReadingExportT1: { type: "number" format: "double" description: "The Meter Counter Reading only export (Tariff 1)" } CounterReadingExportT2: { type: "number" format: "double" description: "The Meter Counter Reading only export (Tariff 2)" } CounterReadingT1: { type: "number" format: "double" description: "The Meter Counter Reading Tariff 1 in kWh or m3." } CounterReadingT2: { type: "number" format: "double" description: "The Meter Counter Reading Tariff 2 in kWh or m3." } Current: { type: "number" format: "double" description: "The Current (in A)" } CurrentL1: { type: "number" format: "double" description: "The Current Phase L1 (in A)" } CurrentL2: { type: "number" format: "double" description: "The Current Phase L2 (in A)" } CurrentL3: { type: "number" format: "double" description: "The Current Phase L3 (in A)" } DeviceEnergyType: { type: "string" description: "The Energy Type of this device" enum: ["MeterTypeUnknown", "MeterTypeElectricity", "MeterTypeWater", "MeterTypeGas", "MeterTypeHeat", "MeterTypeHCA", "MeterTypeAllMeters", "MeterTypeTemperature", "MeterTypeMBusGateway", "MeterTypeRS485Gateway", "MeterTypeCustomDevice", "MeterTypeCompressedAir", "MeterTypeSolarLog", "MeterTypeVirtualMeter", "MeterTypeWMBusGateway"] } DigitalInput1: { type: "boolean" description: "The digital input number 1" } Id: { type: "string" description: "The ID of the device" } MeterSubType: { type: "string" description: "The Sub Type of this Meter." enum: ["MeterSubTypeUnknown", "MeterSubTypeCold", "MeterSubTypeHeat", "MeterSubTypeChargingStation", "MeterSubTypeElectricity", "MeterSubTypeWater", "MeterSubTypeGas", "MeterSubTypeElectricityHeat", "MeterSubTypeTemperature", "MeterSubTypeVirtualBattery"] } Name: { type: "string" description: "The Name of the Device" } PowerFactor: { type: "number" format: "double" description: "The Power Factor (cos phi). Range: 0 - 1" } PowerFactorL1: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L1. Range: 0 - 1" } PowerFactorL2: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L2. Range: 0 - 1" } PowerFactorL3: { type: "number" format: "double" description: "The Power Factor (cos phi) Phase L3. Range: 0 - 1" } Serial: { type: "integer" format: "int64" description: "The Serial number" } Temperature: { type: "number" format: "double" description: "The Temperature (in degree celsius)" } ValueDate: { type: "string" format: "date-time" description: "The Date of the Value (in UTC). If this is null the Server Time is used." } Voltage: { type: "number" format: "double" description: "The Voltage (in V)" } VoltageL1: { type: "number" format: "double" description: "The Voltage Phase L1 (in V)" } VoltageL2: { type: "number" format: "double" description: "The Voltage Phase L2 (in V)" } VoltageL3: { type: "number" format: "double" description: "The Voltage Phase L3 (in V)" } } } }