POST api/v1/Channel

Retrieve the list of channels.
A channel is an attribute of an order and tells Caliq where the order came from
Typical values would be 'Web', 'Trade Show', 'Sales Rep'
The channel is a mandatory field when creating an order

Request Information

URI Parameters

None.

Body Parameters

Params
NameDescriptionTypeAdditional information
apiKey

Please contact Caliq support to get your key

string

Required

Max length: 30

Request Formats

application/json, text/json

Sample: 
{
  "apiKey": "sample string 1"
}

application/xml, text/xml

Sample: 
<Params xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <apiKey>sample string 1</apiKey>
</Params>

Response Information

Resource Description

Returns:
200 OK Returns a list of supported channels as XML or JSON
400 Bad Request - parameters supplied cannot be properly interpreted
401 Not Authorised if supplied api key is not valid
204 No Content if there are no matching records in Caliq
503 Service Unavailable

Channels
NameDescriptionTypeAdditional information
ChannelList

Collection of Channel

None.

Response Formats

application/json, text/json

Sample: 
{
  "ChannelList": [
    {
      "ID": 64,
      "Description": "sample string 2"
    },
    {
      "ID": 64,
      "Description": "sample string 2"
    }
  ]
}

application/xml, text/xml

Sample: 
<Channels xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Channel>
    <ID>64</ID>
    <Description>sample string 2</Description>
  </Channel>
  <Channel>
    <ID>64</ID>
    <Description>sample string 2</Description>
  </Channel>
</Channels>