Platform API

GetSettingsForAppliance

Returns system settings for a specified appliance.

using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using Eros.Subtle.Canvara.WebAPIModel.ServiceModel;

namespace Eros.Subtle.Canvara.WebAPIModel.ServiceModel
{
    ///<summary>
    ///Returns system settings for a specified appliance.
    ///</summary>
    [Api(Description="Returns system settings for a specified appliance.")]
    public partial class GetSettingsForAppliance
    {
        ///<summary>
        ///The appliance ID to return settings for.
        ///</summary>
        [ApiMember(DataType="Guid", Description="The appliance ID to return settings for.", IsRequired=true, Name="ApplianceId", ParameterType="query")]
        public virtual Guid ApplianceId { get; set; }

        ///<summary>
        ///A list of the setting Id's that are to be retrieved.
        ///</summary>
        [ApiMember(DataType="Guid", Description="A list of the setting Id's that are to be retrieved.", IsRequired=true, Name="SettingIds", ParameterType="query")]
        public virtual List<Guid> SettingIds { get; set; } = [];
    }

}

C# GetSettingsForAppliance 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.

POST /xml/reply/GetSettingsForAppliance HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetSettingsForAppliance xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModel">
  <ApplianceId>00000000-0000-0000-0000-000000000000</ApplianceId>
  <SettingIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </SettingIds>
</GetSettingsForAppliance>

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

<ArrayOfSettingsModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModel">
  <SettingsModel>
    <SettingId>00000000-0000-0000-0000-000000000000</SettingId>
    <SettingName>String</SettingName>
    <SettingValue>String</SettingValue>
  </SettingsModel>
</ArrayOfSettingsModel>