<%= render 'response' %>

Create a Channel

To create a new Channel, send an HTTP POST to <%= @ssl_api_domain %>channels.json.xml .

Valid parameters:

api_key (string) - User's API Key; please note that this is different than a Channel API key, and can be found in your account details. (required).
description (string) - Description of the Channel (optional)
elevation (integer) - Elevation in meters (optional)
field1 (string) - Field1 name (optional)
field2 (string) - Field2 name (optional)
field3 (string) - Field3 name (optional)
field4 (string) - Field4 name (optional)
field5 (string) - Field5 name (optional)
field6 (string) - Field6 name (optional)
field7 (string) - Field7 name (optional)
field8 (string) - Field8 name (optional)
latitude (decimal) - Latitude in degrees (optional)
longitude (decimal) - Longitude in degrees (optional)
name (string) - Name of the Channel (optional)
public_flag (true/false) - Whether the Channel should be public, default false (optional)
tags (string) - Comma-separated list of tags (optional)
url (string) - Webpage URL for the Channel (optional)

Example POST:

POST <%= @ssl_api_domain %>channels.json.xml
     api_key=<%= @user_api_key %>
     name=My New Channel

The response will be a webpage with your newly created Channel.

The response will be a JSON object of the new channel, for example:

{
  "id": 4,
  "name": "My New Channel",
  "description": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "hans",
  "tags": [],
  "api_keys":
  [
    {
      "api_key": "XXXXXXXXXXXXXXXX",
      "write_flag": true
    }
  ]
}

The response will be an XML object of the new channel, for example:

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">4</id>
    <name>My New Channel</name>
    <description nil="true" />
    <latitude type="decimal" nil="true" />
    <longitude type="decimal" nil="true" />
    <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at>
    <elevation nil="true" />
    <last-entry-id type="integer" nil="true" />
    <ranking type="integer">15</ranking>
    <username>hans</username>
    <tags type="array" />
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
    </api-keys>
</channel>