Server

<back to all web services

GetDevice

Devices
Requires Authentication
The following routes are available for this service:
GET/api/v1/devices/{Guid}
<?php namespace dtos;

use DateTime;
use Exception;
use DateInterval;
use JsonSerializable;
use ServiceStack\{IReturn,IReturnVoid,IGet,IPost,IPut,IDelete,IPatch,IMeta,IHasSessionId,IHasBearerToken,IHasVersion};
use ServiceStack\{ICrud,ICreateDb,IUpdateDb,IPatchDb,IDeleteDb,ISaveDb,AuditBase,QueryDb,QueryDb2,QueryData,QueryData2,QueryResponse};
use ServiceStack\{ResponseStatus,ResponseError,EmptyResponse,IdResponse,ArrayList,KeyValuePair2,StringResponse,StringsResponse,Tuple2,Tuple3,ByteArray};
use ServiceStack\{JsonConverters,Returns,TypeContext};


enum EinheitType : string
{
    case L = 'L';
    case Kg = 'Kg';
    case CBM = 'CBM';
    case Stck = 'Stck';
    case KWH = 'KWH';
    case MWH = 'MWH';
    case GWH = 'GWH';
    case T = 'T';
    case RM = 'RM';
    case Einheit = 'Einheit';
    case Qm = 'Qm';
    case GJ = 'GJ';
    case MJ = 'MJ';
    case Null = 'Null';
    case St = 'St';
    case Srm = 'Srm';
    case Wh = 'Wh';
}

// @DataContract
class DeviceCatalog implements JsonSerializable
{
    public function __construct(
        // @DataMember(Name="Guid")
        /** @var string|null */
        public ?string $Guid=null,

        // @DataMember(Name="TypKurz")
        /** @var string|null */
        public ?string $TypKurz=null,

        // @DataMember(Name="TypLang")
        /** @var string|null */
        public ?string $TypLang=null,

        // @DataMember(Name="Ablesbar")
        /** @var bool|null */
        public ?bool $Ablesbar=null,

        // @DataMember(Name="Klasse")
        /** @var string|null */
        public ?string $Klasse=null,

        // @DataMember(Name="Abzug")
        /** @var bool|null */
        public ?bool $Abzug=null,

        // @DataMember(Name="Hkvv")
        /** @var bool|null */
        public ?bool $Hkvv=null,

        // @DataMember(Name="Funk")
        /** @var bool|null */
        public ?bool $Funk=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['Guid'])) $this->Guid = $o['Guid'];
        if (isset($o['TypKurz'])) $this->TypKurz = $o['TypKurz'];
        if (isset($o['TypLang'])) $this->TypLang = $o['TypLang'];
        if (isset($o['Ablesbar'])) $this->Ablesbar = $o['Ablesbar'];
        if (isset($o['Klasse'])) $this->Klasse = $o['Klasse'];
        if (isset($o['Abzug'])) $this->Abzug = $o['Abzug'];
        if (isset($o['Hkvv'])) $this->Hkvv = $o['Hkvv'];
        if (isset($o['Funk'])) $this->Funk = $o['Funk'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->Guid)) $o['Guid'] = $this->Guid;
        if (isset($this->TypKurz)) $o['TypKurz'] = $this->TypKurz;
        if (isset($this->TypLang)) $o['TypLang'] = $this->TypLang;
        if (isset($this->Ablesbar)) $o['Ablesbar'] = $this->Ablesbar;
        if (isset($this->Klasse)) $o['Klasse'] = $this->Klasse;
        if (isset($this->Abzug)) $o['Abzug'] = $this->Abzug;
        if (isset($this->Hkvv)) $o['Hkvv'] = $this->Hkvv;
        if (isset($this->Funk)) $o['Funk'] = $this->Funk;
        return empty($o) ? new class(){} : $o;
    }
}

enum DeviceReadingKind : string
{
    case ZA = 'ZA';
    case HA = 'HA';
    case MO = 'MO';
    case EB = 'EB';
    case AB = 'AB';
}

// @DataContract
class DeviceConsumption implements JsonSerializable
{
    public function __construct(
        // @DataMember
        /** @var string */
        public string $guid='',

        // @DataMember
        /** @var float|null */
        public ?float $deviceReading=null,

        // @DataMember
        /** @var DateTime|null */
        public ?DateTime $deviceReadingDate=null,

        // @DataMember
        /** @var DeviceReadingKind|null */
        public ?DeviceReadingKind $deviceReadingKind=null,

        // @DataMember
        /** @var DateTime|null */
        public ?DateTime $changeDate=null,

        // @DataMember
        /** @var string|null */
        public ?string $note=null,

        // @DataMember
        /** @var string|null */
        public ?string $ampouleColour=null,

        // @DataMember
        /** @var string|null */
        public ?string $deviceGuid=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['guid'])) $this->guid = $o['guid'];
        if (isset($o['deviceReading'])) $this->deviceReading = $o['deviceReading'];
        if (isset($o['deviceReadingDate'])) $this->deviceReadingDate = JsonConverters::from('DateTime', $o['deviceReadingDate']);
        if (isset($o['deviceReadingKind'])) $this->deviceReadingKind = JsonConverters::from('DeviceReadingKind', $o['deviceReadingKind']);
        if (isset($o['changeDate'])) $this->changeDate = JsonConverters::from('DateTime', $o['changeDate']);
        if (isset($o['note'])) $this->note = $o['note'];
        if (isset($o['ampouleColour'])) $this->ampouleColour = $o['ampouleColour'];
        if (isset($o['deviceGuid'])) $this->deviceGuid = $o['deviceGuid'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->guid)) $o['guid'] = $this->guid;
        if (isset($this->deviceReading)) $o['deviceReading'] = $this->deviceReading;
        if (isset($this->deviceReadingDate)) $o['deviceReadingDate'] = JsonConverters::to('DateTime', $this->deviceReadingDate);
        if (isset($this->deviceReadingKind)) $o['deviceReadingKind'] = JsonConverters::to('DeviceReadingKind', $this->deviceReadingKind);
        if (isset($this->changeDate)) $o['changeDate'] = JsonConverters::to('DateTime', $this->changeDate);
        if (isset($this->note)) $o['note'] = $this->note;
        if (isset($this->ampouleColour)) $o['ampouleColour'] = $this->ampouleColour;
        if (isset($this->deviceGuid)) $o['deviceGuid'] = $this->deviceGuid;
        return empty($o) ? new class(){} : $o;
    }
}

// @DataContract
class Device implements JsonSerializable
{
    public function __construct(
        // @DataMember
        /** @var string */
        public string $guid='',

        // @DataMember
        /** @var string|null */
        public ?string $number=null,

        // @DataMember
        /** @var string|null */
        public ?string $label=null,

        // @DataMember
        /** @var string|null */
        public ?string $description=null,

        // @DataMember
        /** @var DateTime */
        public DateTime $installationDate=new DateTime(),

        // @DataMember
        /** @var DateTime|null */
        public ?DateTime $deinstallationDate=null,

        // @DataMember
        /** @var DateTime|null */
        public ?DateTime $calibrationDate=null,

        // @DataMember
        /** @var EinheitType|null */
        public ?EinheitType $unit=null,

        // @DataMember
        /** @var string|null */
        public ?string $note=null,

        // @DataMember
        /** @var DeviceCatalog|null */
        public ?DeviceCatalog $deviceCatalog=null,

        // @DataMember
        /** @var array<DeviceConsumption>|null */
        public ?array $deviceConsumptions=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['guid'])) $this->guid = $o['guid'];
        if (isset($o['number'])) $this->number = $o['number'];
        if (isset($o['label'])) $this->label = $o['label'];
        if (isset($o['description'])) $this->description = $o['description'];
        if (isset($o['installationDate'])) $this->installationDate = JsonConverters::from('DateTime', $o['installationDate']);
        if (isset($o['deinstallationDate'])) $this->deinstallationDate = JsonConverters::from('DateTime', $o['deinstallationDate']);
        if (isset($o['calibrationDate'])) $this->calibrationDate = JsonConverters::from('DateTime', $o['calibrationDate']);
        if (isset($o['unit'])) $this->unit = JsonConverters::from('EinheitType', $o['unit']);
        if (isset($o['note'])) $this->note = $o['note'];
        if (isset($o['deviceCatalog'])) $this->deviceCatalog = JsonConverters::from('DeviceCatalog', $o['deviceCatalog']);
        if (isset($o['deviceConsumptions'])) $this->deviceConsumptions = JsonConverters::fromArray('DeviceConsumption', $o['deviceConsumptions']);
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->guid)) $o['guid'] = $this->guid;
        if (isset($this->number)) $o['number'] = $this->number;
        if (isset($this->label)) $o['label'] = $this->label;
        if (isset($this->description)) $o['description'] = $this->description;
        if (isset($this->installationDate)) $o['installationDate'] = JsonConverters::to('DateTime', $this->installationDate);
        if (isset($this->deinstallationDate)) $o['deinstallationDate'] = JsonConverters::to('DateTime', $this->deinstallationDate);
        if (isset($this->calibrationDate)) $o['calibrationDate'] = JsonConverters::to('DateTime', $this->calibrationDate);
        if (isset($this->unit)) $o['unit'] = JsonConverters::to('EinheitType', $this->unit);
        if (isset($this->note)) $o['note'] = $this->note;
        if (isset($this->deviceCatalog)) $o['deviceCatalog'] = JsonConverters::to('DeviceCatalog', $this->deviceCatalog);
        if (isset($this->deviceConsumptions)) $o['deviceConsumptions'] = JsonConverters::toArray('DeviceConsumption', $this->deviceConsumptions);
        return empty($o) ? new class(){} : $o;
    }
}

class GetDeviceResponse implements JsonSerializable
{
    public function __construct(
        /** @var Device|null */
        public ?Device $device=null,
        /** @var ResponseStatus|null */
        public ?ResponseStatus $responseStatus=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['device'])) $this->device = JsonConverters::from('Device', $o['device']);
        if (isset($o['responseStatus'])) $this->responseStatus = JsonConverters::from('ResponseStatus', $o['responseStatus']);
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->device)) $o['device'] = JsonConverters::to('Device', $this->device);
        if (isset($this->responseStatus)) $o['responseStatus'] = JsonConverters::to('ResponseStatus', $this->responseStatus);
        return empty($o) ? new class(){} : $o;
    }
}

class GetDevice implements IHasBearerToken, JsonSerializable
{
    public function __construct(
        // @ApiMember(IsRequired=true, ParameterType="query")
        /** @var string */
        public string $bearerToken='',

        // @ApiMember(IsRequired=true, ParameterType="path")
        /** @var string */
        public string $guid=''
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['bearerToken'])) $this->bearerToken = $o['bearerToken'];
        if (isset($o['guid'])) $this->guid = $o['guid'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->bearerToken)) $o['bearerToken'] = $this->bearerToken;
        if (isset($this->guid)) $o['guid'] = $this->guid;
        return empty($o) ? new class(){} : $o;
    }
}

PHP GetDevice DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /api/v1/devices/{Guid} HTTP/1.1 
Host: calotec-portal-servdesk.eras-online.de 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetDeviceResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eras2Web.Service.Desktop.Server.ServiceModel.Eras2WebExt.Get">
  <Device xmlns:d2p1="http://schemas.datacontract.org/2004/07/Eras2Web.Service.Desktop.Server.ServiceModel.Eras2WebExt.Models">
    <d2p1:CalibrationDate>0001-01-01T00:00:00</d2p1:CalibrationDate>
    <d2p1:DeinstallationDate>0001-01-01T00:00:00</d2p1:DeinstallationDate>
    <d2p1:Description>String</d2p1:Description>
    <d2p1:DeviceCatalog xmlns:d3p1="http://schemas.datacontract.org/2004/07/Eras2Web.Service.Desktop.Server.ServiceModel.Stammdaten">
      <d3p1:Ablesbar>false</d3p1:Ablesbar>
      <d3p1:Abzug>false</d3p1:Abzug>
      <d3p1:Funk>false</d3p1:Funk>
      <d3p1:Guid>String</d3p1:Guid>
      <d3p1:Hkvv>false</d3p1:Hkvv>
      <d3p1:Klasse>String</d3p1:Klasse>
      <d3p1:TypKurz>String</d3p1:TypKurz>
      <d3p1:TypLang>String</d3p1:TypLang>
    </d2p1:DeviceCatalog>
    <d2p1:DeviceConsumptions>
      <d2p1:DeviceConsumption>
        <d2p1:AmpouleColour>String</d2p1:AmpouleColour>
        <d2p1:ChangeDate>0001-01-01T00:00:00</d2p1:ChangeDate>
        <d2p1:DeviceGuid>String</d2p1:DeviceGuid>
        <d2p1:DeviceReading>0</d2p1:DeviceReading>
        <d2p1:DeviceReadingDate>0001-01-01T00:00:00</d2p1:DeviceReadingDate>
        <d2p1:DeviceReadingKind>ZA</d2p1:DeviceReadingKind>
        <d2p1:Guid>00000000-0000-0000-0000-000000000000</d2p1:Guid>
        <d2p1:Note>String</d2p1:Note>
      </d2p1:DeviceConsumption>
    </d2p1:DeviceConsumptions>
    <d2p1:Guid>00000000-0000-0000-0000-000000000000</d2p1:Guid>
    <d2p1:InstallationDate>0001-01-01T00:00:00</d2p1:InstallationDate>
    <d2p1:Label>String</d2p1:Label>
    <d2p1:Note>String</d2p1:Note>
    <d2p1:Number>String</d2p1:Number>
    <d2p1:Unit>L</d2p1:Unit>
  </Device>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</GetDeviceResponse>