api
/api/account/create_custom
June 18, 2008 5:38 PM
This creates a custom data set. You will be able to then populate it with data using the api or via trendrr.com. This will count as 1 towards your total Data Set limit.

authentication is required

params:
return This value specifies how you would like the response sent back.

Possible Values:
  • xml (Default) an xml feed
  • json returns the feed in JSON format
legend_text (required) This is the value that will be displayed in the legend of the graph.
require_authentication if you set this to true, you must provide authentication in order to add data to this dataset. if false, you can add data using only the dataset_key.

Possible Values:
  • true
  • false
invert_values set this to true if lower values should appear above higher values. This is useful for Data Sets dealing with rank: i.e. number 1 is a higher rank then number 2.

Possible Values:
  • true
  • false (Default)
tags Tags help keep your data organized. This should be a url encoded string where each tag is separated by a space.


Example:
http://www.trendrr.com/api/account/create_custom?auth={authentication}&legend_text=My Example Data Set&require_authentication=true


<?xml version="1.0" encoding="UTF-8"?>

<result>
  <graphsCreated>1</graphsCreated>
  <datasetsRemaining>9</datasetsRemaining>
  <datasetsMax>10</datasetsMax>
  <datasetKey>{removed}</datasetKey>
  <graph>
    <title>My Example Data Set (Custom Data Set)</title>
    <createdOn>2009-07-16T17:17:09</createdOn>
    <id>508558</id>
    <link>http://www.trendrr.com/timeseries/My_Example_Data_Set_(Custom_Data_Set)__508558</link>
    <creator>dustin</creator>
    <creatorUrl>http://www.trendrr.com/user/dustin</creatorUrl>
    <graphType>overlay</graphType>
    <graphScale>absolute</graphScale>
    <timeFrameStart>2009-06-16T17:17:09</timeFrameStart>
    <timeFrameEnd>2009-07-16T17:17:09</timeFrameEnd>
    <numDatasets>1</numDatasets>
    <datasets>
      <dataset>
        <dataSourceName>Custom Data Set</dataSourceName>
        <dataStartedCollecting>2009-07-16T17:17:09</dataStartedCollecting>
        <color>FF0000</color>
        <input>My Example Data Set</input>
        <legendText>My Example Data Set</legendText>
        <renderType>line</renderType>
        <invert>false</invert>
        <id>647357</id>
        <totalPoints>0</totalPoints>
        <drawTrendLine>false</drawTrendLine>
        <values />
        <dataStartedCollecting>2009-07-16T17:17:09</dataStartedCollecting>
      </dataset>
    </datasets>
  </graph>
  <resultCode>1</resultCode>
  <resultMessage>Successfully processed request</resultMessage>

</result>