Documentation Center

Viz Channel Branding User Guide

Version 5.1 | Published October 26, 2023 ©

GET Channel

Returns a definitions for a single specific channel.

Syntax

GET /config/channels/{channel}

Request

GET /config/channels/Test HTTP/1.1

Response - Channel returned

HTTP/1.1 200 OK
Content-Type: application/vizrt.promoserver+xml; type=channel
<promoserver:channel xmlns:promoserver="http://www.vizrt.com/promoserver">
<promoserver:refLink rel="self" type="application/vizrt.promoserver+xml; type=channel" href="http://localhost:9980/config/channels/Test" />
<promoserver:refLink rel="edit" type="application/vizrt.promoserver+xml; type=channel" href="http://localhost:9980/config/channels/Test" />
<promoserver:refLink rel="machineaddresses" type="application/vizrt.promoserver+xml; type=machineAddressesList" href="http://localhost:9980/config/channels/Test/machineaddresses" />
<promoserver:name>Test</promoserver:name>
<promoserver:machineAddressInUse>localhost</promoserver:machineAddressInUse>
</promoserver:channel>

Error Response - Channel not found

HTTP/1.1 404 Not Found
Content-Type: application/xml; charset=utf-8
<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">Element Test could not be found</string>

Disallowed Actions

This end-point does not allow POST, and will return a 'HTTP/1.1 405 Method Not Allowed'.