Server

<back to all web services

GetDeviceList

Devices
Requires Authentication
The following routes are available for this service:
GET/api/v1/devices
Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports Eras2Web.Service.Desktop.Server.ServiceModel.Eras2WebExt.Get
Imports Eras2Web.Service.Desktop.Server.ServiceModel.Eras2Client.Models

Namespace Global

    Namespace Eras2Web.Service.Desktop.Server.ServiceModel.Eras2Client.Models

        <DataContract>
        Public Partial Class Device
            <DataMember(Name:="Guid")>
            Public Overridable Property Guid As String

            <DataMember(Name:="Geraetenummer")>
            Public Overridable Property Number As String

            <DataMember(Name:="Bezeichnung")>
            Public Overridable Property Label As String

            <DataMember(Name:="Beschreibung")>
            Public Overridable Property Description As String

            <DataMember(Name:="Einbaudatum")>
            Public Overridable Property InstallationDate As Date

            <DataMember(Name:="Ausbaudatum")>
            Public Overridable Property DeinstallationDate As Nullable(Of Date)

            <DataMember(Name:="Eichdatum")>
            Public Overridable Property CalibrationDate As Nullable(Of Date)

            <DataMember(Name:="Einheit")>
            Public Overridable Property Unit As String

            <DataMember(Name:="Memo")>
            Public Overridable Property Note As String

            <DataMember(Name:="DeviceCatalogGuid")>
            Public Overridable Property DeviceCatalogGuid As String
        End Class
    End Namespace

    Namespace Eras2Web.Service.Desktop.Server.ServiceModel.Eras2WebExt.Get

        Public Partial Class GetDeviceList
            Implements IHasBearerToken
            <ApiMember(IsRequired:=true, ParameterType:="query")>
            Public Overridable Property BearerToken As String

            '''<Summary>
            '''Optional! Follow the format : /api/v1/devices?filter[ObjektGuid]=*
            '''</Summary>
            <DataMember(Name:="filter[ObjektGuid]")>
            <ApiMember(Description:="Optional! Follow the format : /api/v1/devices?filter[ObjektGuid]=*", ParameterType:="query")>
            Public Overridable Property FilterByObjektGuid As String

            '''<Summary>
            '''Optional! Follow the format : /api/v1/devices?filter[NutzerGuid]=*
            '''</Summary>
            <DataMember(Name:="filter[NutzerGuid]")>
            <ApiMember(Description:="Optional! Follow the format : /api/v1/devices?filter[NutzerGuid]=*", ParameterType:="query")>
            Public Overridable Property FilterByNutzeinheitGuid As String
        End Class

        Public Partial Class GetDeviceListResponse
            Public Overridable Property DeviceList As IEnumerable(Of Device)
            Public Overridable Property ResponseStatus As ResponseStatus
        End Class
    End Namespace
End Namespace

VB.NET GetDeviceList DTOs

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

HTTP + JSV

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

GET /api/v1/devices HTTP/1.1 
Host: messdienstservice-stadtwerke-peine-servdesk.eras-online.de 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}