Go back to Partigi API Documentation

 

Review element is what link Partigi users with the items they consume. Reviews are opinions expressed in different ways: a numerical rating between 0 to 5, a text that gives information, the status, tags or emotions.

 

A review, at the moment, has three possible status: user wants to consume it, user has consumed it and user has consumed it and also has it.

 

The language of the review text is given also.

 

Schema

 

ptReview = element atom:entry {
  atomCategory,
  atomUpdated,
  atomTitle,
  atomAuthor,
  atomContent,
  atomSummary,
  ptReview:id,
  element ptItem:id,
  element ptUser:id,
  ptReview:status,
  ptReview:purchased_status, 
  ptReview:language,
  ptReview:tag*,
  ptReview:emotion*,
  element hReview:review
}

 

The table below details review schema: 

 

Element	Property	Description
entry	atom:category	Scheme: http://schemas.partigi.com/v1.0#kind Term: http://schemas.partigi.com/v1.0#review
	atom:updated	The last modification time of the review.
	atom:title	The title of the review.
	atom:author	The author of the review.
	atom:summary	The summary of the review content.
	atom:content	The text of the review.
	ptReview:id	The identfier of the review in Partigi
	ptReview:status	The consume relationship between the user and the item reviewed (see available review status page)
	ptReview:purchased_status	The purchased relationship between the user and the item reviewed (see available review status page)
	ptReview:language	The language in which the review has been written.
	ptReview:tag*	Keywords the review has been tagged with.
	ptReview:emotion*	List of the emotions the item has been marked with by the user. It has the property lang (the language country code)
ptItem:id		The id of the item reviewed.
ptUser:id		The id of the user that made the review.
hReview:review

 

 

An example

 

  <entry xmlns:ptUser="http://schemas.partigi.com/v1.0/ptUser" xmlns:hReview="http://schemas.partigi.com/v1.0/hReview" xmlns:ptReview="http://schemas.partigi.com/v1.0/ptReview" xmlns:ptItem="http://schemas.partigi.com/v1.0/ptItem">
    <category scheme="http://schemas.partigi.com/v1.0#kind" term="http://schemas.partigi.com/v1.0#review"/>
    <id>http://www.partigi.com/api/v1/reviews/show.atom?id=28070</id>
    <title>El baile de la victoria</title>
    <updated>2009-09-24T08:35:06Z</updated>
    <published>2009-09-24T08:35:06Z</published>
    <link type="application/atom+xml" href="http://www.partigi.com/api/v1/reviews/show.atom?id=28070" rel="self"/>
    <link type="text/html" href="http://www.partigi.com/films/el-baile-la-victoria/blat" rel="alternate"/>
    <author>
      <name>Fernando Blat</name>
    </author>
    <content type="text"></content>
    <content type="html">
      <![CDATA[    
      <div>
        <a href="http://www.partigi.com/films/el-baile-la-victoria">
          <img src="http://s3.amazonaws.com/partigiprod/films/posters/44870/diario_g_94__1__thumb.jpg" alt="El baile de la victoria's poster" />
        </a>
      </div>
      <div>
        <p>
          <a href="http://www.partigi.com/blat">Fernando Blat (blat)</a> wants to see it (no rating) <a href="http://www.partigi.com/films/el-baile-la-victoria/blat">#</a>"
        </p>
      </div>
  ]]>
    </content>
    <ptReview:id>28070</ptReview:id>
    <ptItem:id>16363</ptItem:id>
    <ptItem:type>film</ptItem:type>
    <ptUser:id>2</ptUser:id>
    <ptReview:status>0</ptReview:status>

    <ptReview:purchased_status>1</ptReview:purchased_status>

<ptReview:language></ptReview:language> <hReview:review> <hReview:item> <hReview:fn>El baile de la victoria</hReview:fn> <hReview:url>http://www.partigi.com/films/el-baile-la-victoria</hReview:url> </hReview:item> <hReview:rating>0</hReview:rating> </hReview:review> </entry>

Go back to Partigi API Documentation