Go-to-Light Service 4.0.0.2397 - 121 - API License to Cloud Demo

<back to all web services

ShowQuantity

Requires Authentication
The following routes are available for this service:
All Verbs/ShowQuantity/{Key}/{Color}/{Quantity}/{Persistant}
<?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};


class ShowCommon implements JsonSerializable
{
    public function __construct(
        /** @description HTML Color code (e.g. FF00FF) */
        // @ApiMember(Description="HTML Color code (e.g. FF00FF)", IsRequired=true)
        /** @var string */
        public string $Color='',

        /** @description When set to false, it turns off the same color in a previous position */
        // @ApiMember(Description="When set to false, it turns off the same color in a previous position", IsRequired=true)
        /** @var bool|null */
        public ?bool $Persistant=null,

        /** @description Optional: delay the execution of the command (in seconds) */
        // @ApiMember(Description="Optional: delay the execution of the command (in seconds)")
        /** @var int|null */
        public ?int $Delay=null,

        /** @description Optional: duration of the show in seconds */
        // @ApiMember(Description="Optional: duration of the show in seconds")
        /** @var int|null */
        public ?int $Duration=null,

        /** @description Optional: name of the stockroom where to show the position */
        // @ApiMember(Description="Optional: name of the stockroom where to show the position")
        /** @var string */
        public string $StockroomName='',

        /** @description Optional: name of the owner of the color/command to allow color sharing */
        // @ApiMember(Description="Optional: name of the owner of the color/command to allow color sharing")
        /** @var string */
        public string $Owner='',

        /** @description Optional: indicates if message shall be delivered in an unreliable way (faster) */
        // @ApiMember(Description="Optional: indicates if message shall be delivered in an unreliable way (faster)")
        /** @var bool|null */
        public ?bool $Unreliable=null,

        /** @description Optional: indicates if the header shall be displayed */
        // @ApiMember(Description="Optional: indicates if the header shall be displayed")
        /** @var bool|null */
        public ?bool $DisplayHeader=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['Color'])) $this->Color = $o['Color'];
        if (isset($o['Persistant'])) $this->Persistant = $o['Persistant'];
        if (isset($o['Delay'])) $this->Delay = $o['Delay'];
        if (isset($o['Duration'])) $this->Duration = $o['Duration'];
        if (isset($o['StockroomName'])) $this->StockroomName = $o['StockroomName'];
        if (isset($o['Owner'])) $this->Owner = $o['Owner'];
        if (isset($o['Unreliable'])) $this->Unreliable = $o['Unreliable'];
        if (isset($o['DisplayHeader'])) $this->DisplayHeader = $o['DisplayHeader'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->Color)) $o['Color'] = $this->Color;
        if (isset($this->Persistant)) $o['Persistant'] = $this->Persistant;
        if (isset($this->Delay)) $o['Delay'] = $this->Delay;
        if (isset($this->Duration)) $o['Duration'] = $this->Duration;
        if (isset($this->StockroomName)) $o['StockroomName'] = $this->StockroomName;
        if (isset($this->Owner)) $o['Owner'] = $this->Owner;
        if (isset($this->Unreliable)) $o['Unreliable'] = $this->Unreliable;
        if (isset($this->DisplayHeader)) $o['DisplayHeader'] = $this->DisplayHeader;
        return empty($o) ? new class(){} : $o;
    }
}

class ShowQuantity extends ShowCommon implements JsonSerializable
{
    /**
     * @param string $Color
     * @param bool|null $Persistant
     * @param int|null $Delay
     * @param int|null $Duration
     * @param string $StockroomName
     * @param string $Owner
     * @param bool|null $Unreliable
     * @param bool|null $DisplayHeader
     */
    public function __construct(
        string $Color='',
        ?bool $Persistant=null,
        ?int $Delay=null,
        ?int $Duration=null,
        string $StockroomName='',
        string $Owner='',
        ?bool $Unreliable=null,
        ?bool $DisplayHeader=null,
        /** @description Key identifying a location */
        // @ApiMember(Description="Key identifying a location", IsRequired=true)
        /** @var string */
        public string $Key='',

        /** @description Quantity: number of LED to show */
        // @ApiMember(Description="Quantity: number of LED to show", IsRequired=true)
        /** @var int */
        public int $Quantity=0,

        /** @description Optional: Force blinking */
        // @ApiMember(Description="Optional: Force blinking")
        /** @var bool|null */
        public ?bool $ForceBlink=null,

        /** @description Animated effect selection: 0 = Always ON (no effect), 1 = BLINK_NORMAL, 2 = BLINK_FAST, 3 = BLINK_SLOW, 4 = FADE_IN_OUT_NORMAL, 5 = FADE_IN_OUT_FAST, 6 = FADE_IN_OUT_SLOW, 7 = FADE_OUT_NORMAL, 8 = FADE_OUT_FAST, 9 = FADE_OUT_SLOW */
        // @ApiMember(Description="Animated effect selection: 0 = Always ON (no effect), 1 = BLINK_NORMAL, 2 = BLINK_FAST, 3 = BLINK_SLOW, 4 = FADE_IN_OUT_NORMAL, 5 = FADE_IN_OUT_FAST, 6 = FADE_IN_OUT_SLOW, 7 = FADE_OUT_NORMAL, 8 = FADE_OUT_FAST, 9 = FADE_OUT_SLOW")
        /** @var int|null */
        public ?int $Effect=null
    ) {
        parent::__construct($Color,$Persistant,$Delay,$Duration,$StockroomName,$Owner,$Unreliable,$DisplayHeader);
    }

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

PHP ShowQuantity DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /ShowQuantity/{Key}/{Color}/{Quantity}/{Persistant} HTTP/1.1 
Host: clouddemo.pickeos.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"Key":"String","Quantity":0,"ForceBlink":false,"Effect":0,"Color":"String","Persistant":false,"Delay":0,"Duration":0,"StockroomName":"String","Owner":"String","Unreliable":false,"DisplayHeader":false}