Platform independent develpoment tools for the building of Dis.cuss.it utilities

You need to be signed into the API for steps 2 and 3 (create an account here).
1 - Read through the documentation below to understand the dis.cuss.it API.
2 - Use the test page to gain further understand of the functions the API exposes.
3 - Get started by creating an application.

Overview

The Discussit developers API provides a standards based interface to the Discussit platform. We have made every effort to make the methods logical and easy to understand and have also endevoured to include full documentation, and examples where appropriate.

Authentication

All calls to the API must be digitally signed before any data can be returned. We use the OAuth protocol for authentifcation in our API implementation. This can be a little tricky to understand at first, so please read our authentication guide carefully.

Authentication Guide

When developers create an application for use with the Discussit API, our servers create a Consumer Key and a Consumer Secret. A digital signature is constructed by combining these two parameters with the OAuth Signature Method, Nonce, Timestamp, Token, and TokenSecret parameters.

You must create an application in the developer site to get your Consumer Key and Consumer Secret.

To reach a specific resource on the REST API, you must specify a RequestURL. The RequestURL is a concatenation of http://api.dis.cuss.it/main.svc/[Resource URL].

The OAuth protocol is used to validate the credentials of an application developer by means of the digital signature. If the external application signs the request, and our servers validate the digital signature, the developer is granted access to the requested resource.

This OAuth client test tool can be used as a starting point to familiarize yourself with the oAuth.

OAuth Authorisation Endpoints

http://api.dis.cuss.it/main.svc/getrequesttoken
http://api.dis.cuss.it/main.svc/getaccesstoken

OAuth Parameters

The following are the OAuth parameters required for each REST request.

Required	Name	Data Type	Description
yes	oauth_consumer_key	string	The consumer key associated with the calling application.
yes	oauth_signature_method	string	The signature method used to sign the request.
yes	oauth_signature	string	The oauth signature.
yes	oauth_token	string	The oauth token.
yes	oauth_timestamp	string	The oauth timestamp.
yes	oauth_nonce	string	The oauth none.
no	oauth_version	string	If present must by '1.0'.

The REST API

The Dis.cuss.it API uses a REST-based interface. This means that our method calls are made over the internet by sending HTTP GET or POST requests to our REST server. Currently you can opt to have method results returned as either XML or JSON, depending on your preference.

Methods

Profiles.Get

Get a Profiles for Discussit.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/profiles/get(.xml/.json)

Parameters

Required	Name	Data Type	Description
yes	Identifier	string	The identifying url to the profile.

Example Return XML

Example Return JSON

Messages.Thread.GetByID

Get a thread with its containing messages.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/messages/thread/getbyid(.xml/.json)

Parameters

Required	Name	Data Type	Description
Yes	Thread ID	GUID	The ID of the thread, obtained through using the Messages.Thread.Init method.

Example Return XML

<MessageSet xmlns="http://dis.cuss.it" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <Count>4</Count>
      <MessageList>
        <Message>
          <Body>my fiancees last name his family is from kingsport tennessee</Body>
          <Depth>1</Depth>
          <Email>lilirishlilcherokee@yahoo.com</Email>
          <MessageID>4ed32e70-38db-4545-999f-fbbb2d87aaa4</MessageID>
          <Mugshot />
          <Nickname>victoriasullivan</Nickname>
          <Posted>22/05/2007 19:41:09</Posted>
          <ProfileURL />
          <ReplyTo />
          <SpamSig i:nil="true" />
          <Spaminess>0</Spaminess>
          <Status />
          <ThreadID>74a27851-815a-4482-9a77-26bd4aaf736e</ThreadID>
          <URL>http://www.surnamedb.com/surname.aspx?name=Smith</URL>
        </Message>
        <Message>
          <Body>My mothers maiden name, origin england, ancestor edward smith was believed to be a convict sent to the australian colonies, no other information available</Body>
          <Depth>1</Depth>
          <Email>theresaball@optusnet.com.au</Email>
          <MessageID>19ce6c60-66fc-4d9f-8031-6b10a2ad83f1</MessageID>
          <Mugshot />
          <Nickname>theresa</Nickname>
          <Posted>24/05/2007 22:22:04</Posted>
          <ProfileURL />
          <ReplyTo />
          <SpamSig i:nil="true" />
          <Spaminess>0</Spaminess>
          <Status />
          <ThreadID>74a27851-815a-4482-9a77-26bd4aaf736e</ThreadID>
          <URL>http://www.surnamedb.com/surname.aspx?name=Smith</URL>
        </Message>
        <Message>
          <Body>My mother's maiden name, origin England. Father was Victor Smith from Faversham, Kent born in 1906 to George Smith and Alice Whorlow.</Body>
          <Depth>1</Depth>
          <Email>waikarehana56@hotmail.com</Email>
          <MessageID>f8227de7-2e00-4a8a-bb62-f223e9a9779b</MessageID>
          <Mugshot />
          <Nickname>wai56</Nickname>
          <Posted>18/09/2007 14:20:20</Posted>
          <ProfileURL />
          <ReplyTo />
          <SpamSig i:nil="true" />
          <Spaminess>0</Spaminess>
          <Status />
          <ThreadID>74a27851-815a-4482-9a77-26bd4aaf736e</ThreadID>
          <URL>http://www.surnamedb.com/surname.aspx?name=Smith</URL>
        </Message>
        <Message>
          <Body>Related to the same Smith&apos;s as Elvis. </Body>
          <Depth>1</Depth>
          <Email>annief18_2002@yahoo.com</Email>
          <MessageID>2f0b5e47-e620-4240-bf48-88e7a39b11d9</MessageID>
          <Mugshot />
          <Nickname>Annie</Nickname>
          <Posted>29/08/2009 10:20:47</Posted>
          <ProfileURL />
          <ReplyTo />
          <SpamSig>74c3e23e03v2qujg1tgbmb</SpamSig>
          <Spaminess>0.2</Spaminess>
          <Status>a</Status>
          <ThreadID>74a27851-815a-4482-9a77-26bd4aaf736e</ThreadID>
          <URL>http://www.surnamedb.com/surname.aspx?name=Smith</URL>
        </Message>
      </MessageList>
      <Start>0</Start>
      <WidgetID i:nil="true" />
    </MessageSet>

Example Return JSON

{
	    "Count":4,
	    "MessageList":[{
		    "Body":"my fiancees last name his family is from kingsport tennessee",
		    "Depth":1,
		    "Email":"lilirishlilcherokee@yahoo.com",
		    "MessageID":"4ed32e70-38db-4545-999f-fbbb2d87aaa4",
		    "Mugshot":"",
		    "Nickname":"victoriasullivan",
		    "Posted":"22\/05\/2007 19:41:09",
		    "ProfileURL":"",
		    "ReplyTo":"",
		    "SpamSig":null,
		    "Spaminess":0,
		    "Status":"",
		    "ThreadID":"74a27851-815a-4482-9a77-26bd4aaf736e",
		        "URL":"http:\/\/www.surnamedb.com\/surname.aspx?name=Smith"
	    },
	    {
		    "Body":"My mothers maiden name,
		     origin england,
		     ancestor edward smith was believed to be a convict sent to the australian colonies,
		     no other information available",
		    "Depth":1,
		    "Email":"theresaball@optusnet.com.au",
		    "MessageID":"19ce6c60-66fc-4d9f-8031-6b10a2ad83f1",
		    "Mugshot":"",
		    "Nickname":"theresa",
		    "Posted":"24\/05\/2007 22:22:04",
		    "ProfileURL":"",
		    "ReplyTo":"",
		    "SpamSig":null,
		    "Spaminess":0,
		    "Status":"",
		    "ThreadID":"74a27851-815a-4482-9a77-26bd4aaf736e",
		    "URL":"http:\/\/www.surnamedb.com\/surname.aspx?name=Smith"
	    },
	    {
		    "Body":"My mother's maiden name,
		     origin England. Father was Victor Smith from Faversham,
		     Kent born in 1906 to George Smith and Alice Whorlow.",
		    "Depth":1,
		    "Email":"waikarehana56@hotmail.com",
		    "MessageID":"f8227de7-2e00-4a8a-bb62-f223e9a9779b",
		    "Mugshot":"",
		    "Nickname":"wai56",
		    "Posted":"18\/09\/2007 14:20:20",
		    "ProfileURL":"",
		    "ReplyTo":"",
		    "SpamSig":null,
		    "Spaminess":0,
		    "Status":"",
		    "ThreadID":"74a27851-815a-4482-9a77-26bd4aaf736e",
		    "URL":"http:\/\/www.surnamedb.com\/surname.aspx?name=Smith"
	    },
	    {
		    "Body":"Related to the same Smith's as Elvis. ",
		    "Depth":1,
		    "Email":"annief18_2002@yahoo.com",
		    "MessageID":"2f0b5e47-e620-4240-bf48-88e7a39b11d9",
		    "Mugshot":"",
		    "Nickname":"Annie",
		    "Posted":"29\/08\/2009 10:20:47",
		    "ProfileURL":"",
		    "ReplyTo":"",
		    "SpamSig":"74c3e23e03v2qujg1tgbmb",
		    "Spaminess":0.2,
		    "Status":"a",
		    "ThreadID":"74a27851-815a-4482-9a77-26bd4aaf736e",
		    "URL":"http:\/\/www.surnamedb.com\/surname.aspx?name=Smith"
	    }],
	    "Start":0,
	    "WidgetID":null
    }

Messages.Thread.Init

Get surface data for a thread, including the ThreadID, needed for Messages.Thread.GetByID.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/messages/thread/init(.xml/.json)

Parameters

Required	Name	Data Type	Description
Yes	Url	String	The url where the widget resides.
Yes	Widget ID	GUID	The ID of the widget.

Example Return XML

<Thread xmlns="http://dis.cuss.it" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <Anonymous>true</Anonymous>
      <Colour1>FAFAFA</Colour1>
      <Colour2>212121</Colour2>
      <Colour3>F9FAE6</Colour3>
      <Colour4>CC0000</Colour4>
      <Comments>6</Comments>
      <Created>2009-01-22T15:32:59.377</Created>
      <Documents>true</Documents>
      <Images>true</Images>
      <Language>0</Language>
      <LastAuthor>Tayla Dennis</LastAuthor>
      <LastPost>2009-08-30T03:09:42.983</LastPost>
      <ModType>1</ModType>
      <Music>true</Music>
      <PageBody>
        <span id="ctl00_ContentPlaceHolder1_Surname1_lbl_History" class="SurnameHistory">Recorded in the spellings of Smith, Smithe, Smythe, and the patronymics Smiths, and Smithson, this is the most popular surname in the English speaking world by a considerable margin. Of pre 7th century Anglo-Saxon origins, it derives from the word 'smitan' meaning 'to smite' and as such is believed to have described not a worker in iron, but a soldier, one who smote. That he also probably wore armour, which he would have been required to repair, may have lead to the secondary meaning. The famous Anglo-Saxon Chronicles sometimes known as the first newspaper, in the 9th century a.d. uses the expression 'War-Smith' to describe a valiant warrior, whilst the later medieval Guild List of specialist trades has blacksmith, whitesmith, tinsmith, goldsmith and silversmith amongst its many members, but no trade of 'smith'. These descriptions of the skilled workers of the Middle Ages were exact, and it is our opinion after studying many early records that the original smiths were probably the guards of the local lord of the manor. This would account for the singular popularity of the name, as the early social records indicate that the trades of tailor and baker were much more prevalent than that of Smith in any form.  What is certain is that over five hundred coats of arms have been granted to Smith nameholders, surely an indication of the soldier background, rather than a humble ironworker. The great family Smith is 'first' in all major cities of the English speaking world, yet curiously the greatest concentration of Smith's are in Aberdeenshire, Scotland! Why this should be so is far from clear. Not surprisingly the Smith name was one of the very first into the New American colonies, being held by the famous John Smith (1580 - 1631), explorer and writer, who helped to found the state of Virginia. He was reputedly saved from execution by Pocahontas, the Indian chief's daughter, who died in England in 1622.  The first recorded spelling of the family name, and probably the first surname recorded anywhere in the world,  is that of Eceard Smid. This was dated 975 a.d., in the English Surname Register for County Durham, during the reign of King Edward of England, known as "The Martyr", 975 - 979 a.d.    <p class='copyright'>© Copyright: Name Orgin Research <a href='http://www.surnamedb.com'>www.surnamedb.com</a> 1980 - 2007&nbsp;&nbsp;<script type="text/javascript" src="http://widgets.clearspring.com/launchpad/include.js"></script><script type="text/javascript">$Launchpad.ShowButton({ wid : "4697f27058166cab", config : { "surname" : "Smith" }  });</script></p></span>
      </PageBody>
      <PageSize>50</PageSize>
      <PageTitle>SurnameDB: Smith surname meaning</PageTitle>
      <Public>true</Public>
      <ThreadID>74a27851-815a-4482-9a77-26bd4aaf736e</ThreadID>
      <URL>http://www.surnamedb.com/surname.aspx?name=Smith</URL>
      <Videos>true</Videos>
      <WidgetID>12565704-d041-4790-b3ef-bd1cf6a6152b</WidgetID>
    </Thread>

Example Return JSON

{
	    "Anonymous":true,
	    "Colour1":"FAFAFA",
	    "Colour2":"212121",
	    "Colour3":"F9FAE6",
	    "Colour4":"CC0000",
	    "Comments":6,
	    "Created":"\/Date(1232638379377+0000)\/",
	    "Documents":true,
	    "Images":true,
	    "Language":0,
	    "LastAuthor":"Tayla Dennis",
	    "LastPost":"\/Date(1251598182983+0100)\/",
	    "ModType":1,
	    "Music":true,
	    "PageBody":"\u000d\u000a    <span id=\"ctl00_ContentPlaceHolder1_Surname1_lbl_History\" class=\"SurnameHistory\">Recorded in the spellings of Smith,
	     Smithe,
	     Smythe,
	     and the patronymics Smiths,
	     and Smithson,
	     this is the most popular surname in the English speaking world by a considerable margin. Of pre 7th century Anglo-Saxon origins,
	     it derives from the word 'smitan' meaning 'to smite' and as such is believed to have described not a worker in iron,
	     but a soldier,
	     one who smote. That he also probably wore armour,
	     which he would have been required to repair,
	     may have lead to the secondary meaning. The famous Anglo-Saxon Chronicles sometimes known as the first newspaper,
	     in the 9th century a.d. uses the expression 'War-Smith' to describe a valiant warrior,
	     whilst the later medieval Guild List of specialist trades has blacksmith,
	     whitesmith,
	     tinsmith,
	     goldsmith and silversmith amongst its many members,
	     but no trade of 'smith'. These descriptions of the skilled workers of the Middle Ages were exact,
	     and it is our opinion after studying many early records that the original smiths were probably the guards of the local lord of the manor. This would account for the singular popularity of the name,
	     as the early social records indicate that the trades of tailor and baker were much more prevalent than that of Smith in any form.  What is certain is that over five hundred coats of arms have been granted to Smith nameholders,
	     surely an indication of the soldier background,
	     rather than a humble ironworker. The great family Smith is 'first' in all major cities of the English speaking world,
	     yet curiously the greatest concentration of Smith's are in Aberdeenshire,
	     Scotland! Why this should be so is far from clear. Not surprisingly the Smith name was one of the very first into the New American colonies,
	     being held by the famous John Smith (1580 - 1631),
	     explorer and writer,
	     who helped to found the state of Virginia. He was reputedly saved from execution by Pocahontas,
	     the Indian chief's daughter,
	     who died in England in 1622.  The first recorded spelling of the family name,
	     and probably the first surname recorded anywhere in the world,
	      is that of Eceard Smid. This was dated 975 a.d.,
	     in the English Surname Register for County Durham,
	     during the reign of King Edward of England,
	     known as \"The Martyr\",
	     975 - 979 a.d.    <p class='copyright'>© Copyright: Name Orgin Research <a href='http:\/\/www.surnamedb.com'>www.surnamedb.com<\/a> 1980 - 2007  <script type=\"text\/javascript\" src=\"http:\/\/widgets.clearspring.com\/launchpad\/include.js\"><\/script><script type=\"text\/javascript\">$Launchpad.ShowButton({
		     wid : \"4697f27058166cab\",
		     config : {
			     \"surname\" : \"Smith\" 
		    }  
	    });<\/script><\/p><\/span>\u000d\u000a    ",
	    "PageSize":50,
	    "PageTitle":"SurnameDB: Smith surname meaning",
	    "Public":true,
	    "ThreadID":"74a27851-815a-4482-9a77-26bd4aaf736e",
	    "URL":"http:\/\/www.surnamedb.com\/surname.aspx?name=Smith",
	    "Videos":true,
	    "WidgetID":"12565704-d041-4790-b3ef-bd1cf6a6152b"
    }

Messages.Message.Add

Add a message to a thread.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/messages/message/add(.xml/.json)

Parameters

Required	Name	Data Type	Description
Yes	Url	String	The url where the thread can be viewed.
Yes	Widget ID	GUID	The ID of the widget for the page where the message is being posted.
Dependant on widget	Identifier	String	The identifying url, e.g, openID, Facebook profile.
Yes	Nickname	String	The nickname of the poster.
No	Email	String	An email for the poster. If not supplied the identifier will be used.
No	Web Url	String	A web address for the poster.
Yes	Body	String	The message body.
No	Reply To ID	GUID	The ID of the message if replying to anything other than the root message.
Yes	Notify	Boolean	Poster to recive reply notices by email.

Example Return XML

Example Return JSON

Messages.MessageStatus.Update

Update that status of a message, e.g. mark as withdrawn, aproved or spam.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/messages/status/update(.xml/.json)

Parameters

Required	Name	Data Type	Description
Yes	Message ID	GUID	The ID of the message to change status upon.
Yes	Status	Char	Set the status of a message (a, w or s - approved, withdraw or report spam).

Example Return XML

Example Return JSON

Widgets.Get

Get all sites and contained widgets.

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/widgets/get(.xml/.json)

Parameters

No additional params are needed.

Example Return XML

<SiteSet xmlns="http://dis.cuss.it" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <SiteList>
        <Site>
          <SiteCreated>2009-04-24T11:50:10</SiteCreated>
          <SiteID>2dafe670-0005-0000-a7e7-7322711db883</SiteID>
          <SiteURL>http://blog.dis.cuss.it/</SiteURL>
          <WidgetList>
            <Widget>
              <WidgetCreated>2009-04-24T11:50:10</WidgetCreated>
              <WidgetID>46e7bade-9e46-41d1-000e-1211e0eac0dd</WidgetID>
              <WidgetName>blog</WidgetName>
              <WidgetType>Thread Widget</WidgetType>
            </Widget>
          </WidgetList>
        </Site>
        <Site>
          <SiteCreated>2009-02-16T15:14:41</SiteCreated>
          <SiteID>13ee26d6-3879-0000-818d-ba445c8d4a03</SiteID>
          <SiteURL>http://www.docubate.com</SiteURL>
          <WidgetList>
            <Widget>
              <WidgetCreated>2009-02-16T15:14:41</WidgetCreated>
              <WidgetID>b720dbc3-1236-4dcb-ae2a-10e1348e6a81</WidgetID>
              <WidgetName>Default</WidgetName>
              <WidgetType>Thread Widget</WidgetType>
            </Widget>
          </WidgetList>
        </Site>
        <Site>
          <SiteCreated>2009-01-22T11:00:06</SiteCreated>
          <SiteID>a1440129-82c6-40c5-963a-77a21f111586</SiteID>
          <SiteURL>http://www.surnamedb.com</SiteURL>
          <WidgetList>
            <Widget>
              <WidgetCreated>2009-01-22T11:00:06</WidgetCreated>
              <WidgetID>12565704-d041-4790-b3ef-bd1cf6a6152b</WidgetID>
              <WidgetName>SurnameThread</WidgetName>
              <WidgetType>Thread Widget</WidgetType>
            </Widget>
            <Widget>
              <WidgetCreated>2009-05-06T12:08:13</WidgetCreated>
              <WidgetID>23c49c4e-354e-4277-bd11-4946cd433dd0</WidgetID>
              <WidgetName>TopThreads</WidgetName>
              <WidgetType>Top Threads Widget</WidgetType>
            </Widget>
          </WidgetList>
        </Site>
      </SiteList>
    </SiteSet>

Example Return JSON

{
	    "SiteList":[{
		    "SiteCreated":"\/Date(1240570210000+0100)\/",
		    "SiteID":"2dafe670-0005-0000-a7e7-7322711db883",
		    "SiteURL":"http:\/\/blog.dis.cuss.it\/",
		    "WidgetList":[{
			    "WidgetCreated":"\/Date(1240570210000+0100)\/",
			    "WidgetID":"46e7bade-9e46-41d1-000e-1211e0eac0dd",
			    "WidgetName":"blog",
			    "WidgetType":"Thread Widget"
		    }]
	    },
	    {
		    "SiteCreated":"\/Date(1234797281000+0000)\/",
		    "SiteID":"13ee26d6-3879-0000-818d-ba445c8d4a03",
		    "SiteURL":"http:\/\/www.docubate.com",
		    "WidgetList":[{
			    "WidgetCreated":"\/Date(1234797281000+0000)\/",
			    "WidgetID":"b720dbc3-1236-4dcb-ae2a-10e1348e6a81",
			    "WidgetName":"Default",
			    "WidgetType":"Thread Widget"
		    }]
	    },
	    {
		    "SiteCreated":"\/Date(1232622006000+0000)\/",
		    "SiteID":"a1440129-82c6-40c5-963a-77a21f111586",
		    "SiteURL":"http:\/\/www.surnamedb.com",
		    "WidgetList":[{
			    "WidgetCreated":"\/Date(1232622006000+0000)\/",
			    "WidgetID":"12565704-d041-4790-b3ef-bd1cf6a6152b",
			    "WidgetName":"SurnameThread",
			    "WidgetType":"Thread Widget"
		    },
		    {
			    "WidgetCreated":"\/Date(1241608093000+0100)\/",
			    "WidgetID":"23c49c4e-354e-4277-bd11-4946cd433dd0",
			    "WidgetName":"TopThreads",
			    "WidgetType":"Top Threads Widget"
		    }]
	    }]
    }

Widgets.RecentMessages

Get a set of recent messages for specified a widget

Method Type

POST

Endpoint

http://api.dis.cuss.it/main.svc/widgets/recentmessages(.xml/.json)

Parameters

Required	Name	Data Type	Description
Yes	Widget ID	GUID	The ID of the widget to get recent message for.
Yes	Date From	Date	The date you want to go back to when getting recent messages. (YYYY/MM/DD HH:MM:SS)

Example Return XML

<MessageSet xmlns="http://dis.cuss.it" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <Count>2</Count>
      <MessageList>
        <Message>
          <Body>This was posted through the API again.</Body>
          <Depth>0</Depth>
          <Email>nigel_gossage@yahoo.co.uk</Email>
          <MessageID>7812cebd-0f07-473d-900d-147a5fa2f0ee</MessageID>
          <Mugshot />
          <Nickname>NigelGos</Nickname>
          <Posted>18/09/2009 16:12:40</Posted>
          <ProfileURL>http://dis.cuss.it</ProfileURL>
          <ReplyTo>39793c56-76a2-4dad-a8b4-94e907b30e48</ReplyTo>
          <SpamSig>f8a505f309g0vcbnhmt3ry</SpamSig>
          <Spaminess>0.1</Spaminess>
          <Status />
          <ThreadID>13ba5a74-3464-4fd2-a6a6-ee8dee69e3a2</ThreadID>
          <URL>http://www.docubate.com/doc.mvc/14679766</URL>
        </Message>
        <Message>
          <Body>this was posted through the API</Body>
          <Depth>0</Depth>
          <Email>nigel_gossage@yahoo.co.uk</Email>
          <MessageID>39793c56-76a2-4dad-a8b4-94e907b30e48</MessageID>
          <Mugshot />
          <Nickname>NigelGos</Nickname>
          <Posted>18/09/2009 16:11:06</Posted>
          <ProfileURL>http://dis.cuss.it</ProfileURL>
          <ReplyTo>10357241-e9d2-45bf-a505-49f3715a9e42</ReplyTo>
          <SpamSig>5d2e9c8a73nwhpdfiw6wib</SpamSig>
          <Spaminess>0.1</Spaminess>
          <Status>a</Status>
          <ThreadID>13ba5a74-3464-4fd2-a6a6-ee8dee69e3a2</ThreadID>
          <URL>http://www.docubate.com/doc.mvc/14679766</URL>
        </Message>
      </MessageList>
      <Start>0</Start>
      <WidgetID>b720dbc3-1236-4dcb-ae2a-10e1a48c6a81</WidgetID>
    </MessageSet>

Example Return JSON

{
	    "Count":2,
	    "MessageList":[{
		    "Body":"This was posted through the API again.",
		    "Depth":0,
		    "Email":"nigel_gossage@yahoo.co.uk",
		    "MessageID":"7812cebd-0f07-473d-900d-147a5fa2f0ee",
		    "Mugshot":"",
		    "Nickname":"NigelGos",
		    "Posted":"18\/09\/2009 16:12:40",
		    "ProfileURL":"http:\/\/dis.cuss.it",
		    "ReplyTo":"39793c56-76a2-4dad-a8b4-94e907b30e48",
		    "SpamSig":"f8a505f309g0vcbnhmt3ry",
		    "Spaminess":0.1,
		    "Status":"",
		    "ThreadID":"13ba5a74-3464-4fd2-a6a6-ee8dee69e3a2",
		    "URL":"http:\/\/www.docubate.com\/doc.mvc\/14679766"
	    },
	    {
		    "Body":"this was posted through the API",
		    "Depth":0,
		    "Email":"nigel_gossage@yahoo.co.uk",
		    "MessageID":"39793c56-76a2-4dad-a8b4-94e907b30e48",
		    "Mugshot":"",
		    "Nickname":"NigelGos",
		    "Posted":"18\/09\/2009 16:11:06",
		    "ProfileURL":"http:\/\/dis.cuss.it",
		    "ReplyTo":"10357241-e9d2-45bf-a505-49f3715a9e42",
		    "SpamSig":"5d2e9c8a73nwhpdfiw6wib",
		    "Spaminess":0.1,
		    "Status":"a",
		    "ThreadID":"13ba5a74-3464-4fd2-a6a6-ee8dee69e3a2",
		    "URL":"http:\/\/www.docubate.com\/doc.mvc\/14679766"
	    }],
	    "Start":0,
	    "WidgetID":"b720dbc3-1236-4dcb-ae2a-10e1a48c6a81"
    }

Example Error Codes

Code	Description
400	Bad Request - It's likley that you missed one or more parameters.
401	Authentication failed - Check your oauth client is working correcly.


	Please wait...