Go-to-Light Service 3.1.1.1547 - 97 - API License to GTL Cloud

<back to all web services

PBL_SwitchOnPositions

Requires Authentication
The following routes are available for this service:
All Verbs/PBL_SwitchOnPositions
PBL_SwitchOnPositions Parameters:
NameParameterData TypeRequiredDescription
PositionsqueryList<string>YesList of position identifying LED locations
Effectqueryint?NoOptional: Animated effect selection: 0 = Always ON (no effect, default), 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
ColorquerystringNoOptional: HTML Color code (e.g. FF00FF)
HidePreviousPositionquerybool?NoOptional: When set to true, it turns off the same color in a previous position
OwnerquerystringNoOptional: Name of the owner of the color/command to allow color sharing
PBL_StandardResponse Parameters:
NameParameterData TypeRequiredDescription
SuccessformboolNo
ErrorformstringNo
ResultformObjectNo
ColorformstringNo

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 /PBL_SwitchOnPositions HTTP/1.1 
Host: clouddemo.pickeos.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PBL_SwitchOnPositions xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GoToLightAPI">
  <Color>String</Color>
  <Effect>0</Effect>
  <HidePreviousPosition>false</HidePreviousPosition>
  <Owner>String</Owner>
  <Positions xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </Positions>
</PBL_SwitchOnPositions>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<PBL_StandardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GoToLightAPI">
  <Color>String</Color>
  <Error>String</Error>
  <Result xmlns:d2p1="http://www.w3.org/2001/XMLSchema" i:type="d2p1:anyType" />
  <Success>false</Success>
</PBL_StandardResponse>