Reply

Replies are made to topics or other replies. Similar to topics, they are represented as Atom entries. The annotated sample response below outlines the different features exposed in a reply entry:

view plaincopy to clipboardprint?
  1.  <!-- This is a reply entry -->  
  2.   <entry>  
  3.     <id>http://localhost:3000/topics/27521/replies/54841</id>  
  4.       
  5.       
  6.     <!-- Navigation Links:
  7.       rel=reply:  a link to the individual reply resource.  Represented as a feed-less atom entry  
  8.       rel=topic:  a link back to the topic this reply is posted in  
  9.       rel=stars:  POST here to apply a "This answers the question" star to this reply   
  10.      -->  
  11.        
  12.     <link rel="reply" href="http://localhost:3000/topics/27521/replies/54841" type="application/atom+xml">  
  13.     <link rel="topic" href="http://localhost:3000/topics/27521" type="application/atom+xml">  
  14.     <link rel="stars" href="http://localhost:3000/topics/27521/replies/54841/stars" type="application/atom+xml">  
  15.       
  16.     <!-- This element uses the Atom threading extensions to specify the item to with this reply is being made. -->  
  17.     <thr:in-reply-to>http://localhost:3000/topics/27521</thr:in-reply-to>  
  18.       
  19.     <!-- Satisfaction specific ID -->  
  20.     <sfn:id>54841</sfn:id>  
  21.       
  22.     <!-- Please note that the title is not user-editable, but rather is auto-generated. -->  
  23.     <title>Scott responded to "how can i delete my company or hide it from the public?"</title>  
  24.       
  25.       
  26.     <updated>2007-10-19T16:48:09Z</updated>  
  27.     <published>2007-10-19T16:48:09Z</published>  
  28.     <author>  
  29.       <name>Scott</name>  
  30.       <uri>http://localhost:3000/people/13</uri>  
  31.     </author>  
  32.     <content type="html">  
  33.     You can't.  
  34.   
  35. For a better explanation: http://getsatisfaction.com/satisfaction/topics/satisfaction_is_in_your_hands_but_out_of_your_control  
  36.   
  37. Basically, A Satisfaction site isn't controlled by the company.  It's a place for customers and companies to come together on an equal playing field, free of heavy handed censorship from the company while still giving the company a voice amongst the thousands of dog-piling haters.  
  38.   
  39. ---  
  40.   
  41. On a more personalized note, could you tell me why you would want to hide your company?  
  42.     </content>  
  43.       
  44.     <!--
  45.     Additional Stats  
  46.       
  47.     flag_count:  the number of Abuse/Spam flags that have been added to this reply  
  48.     star_count:  The number of "Mark as useful" stars that have been applied to this reply  
  49.      -->  
  50.     <sfn:flag_count>0</sfn:flag_count>  
  51.     <sfn:star_count>2</sfn:star_count>  
  52.   </entry>  

Posting replies

To post a reply to a topic, you make an HTTP POST to the replies sub-resource of a topic. To find this url, you should look at the <link rel="replies"> element of a topic atom entry. Alternatively, if you know the url of a topic, you can add "/replies" onto the end of it to manually form the replies URL.

The HTTP POST should have a form encoded body that has the parameters described below:

The required parameters include:

reply[content]
The text content of the reply.

The optional parameters include:

reply[emotitag][face]
A value that describes the emoticon face to attach to this reply: one of happy, sad, indifferent, or silly.
reply[emotitag][feeling]
A word or two describing in more detail how you are feeling. Examples include anxious, thankful, or frustrated.
reply[emotitag][intensity]
A rating of 0-3 that describes the intensity of how you are feeling, 3 being the most intense, 0 being the baseline.

version 5 as of 2 years ago by Scott Fleckenstein

Comments

Please sign in to post a comment.