| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

Partigi API - Item Atom Element

Page history last edited by Fernando Blat 14 years, 1 month ago

Go back to Partigi API Documentation

 

Items are the main element in Partigi. They refer to the cultural items you, as a Partigi user, review, share with your friends and recommend. Each type of item is identified by an unique integer identifier and a field type.

 

Schema

 

ptItem = element atom:entry {
atomCategory,
atomUpdated,
atomTitle,
ptItem:id,
ptItem:type,
ptItem:synopsis*,
ptItem:title*,
ptItem:countries*,
ptItem:posters*,
ptItem:credits?,
ptItem:genres*,
ptItem:subgenres*,
ptItem:year?,
ptItem:release_date_es,
ptItem:release_date_us
}

 

The table below details the item common elements: 

 

Element Property Description
entry atom:category Scheme: http://schemas.partigi.com/v1.0#kind
Term: http://schemas.partigi.com/v1.0#item
  atom:updated The last modification time of the item. Notice that an item is updated when a reviews of the item is created or removed.
  atom:title The original title of the item
  ptItem:id The identfier of the item in Partigi
  ptItem:type The type of the item (see item types page)
  ptItem:synopsis* The synopsis of the item. It accepts the properties lang (the language country code) and the content type
  ptItem:title* The localized title of the item. It accepts the property lang (the language country code)
  ptItem:country* The countries in which the item has been made.
  ptItem:poster* The localized poster of the item.  It accepts the property lang (the language country code)
  ptItem:credits?

A list of ptPerson related in some way with the item.

  ptItem:genres* The localized name of one genre of the Item. It accepts the properties lang (the language country code) and a id (the internal representation of the genre).
  ptItem:subgenres* The localized name of one subgenre of the Item. It accepts the properties lang (the language country code) and a id (the internal representation of the subgenre).
  ptItem:year? The year the film was made.
  ptItem:release_date_es? Release date for Spain in the format yyyy-mm-dd
  ptItem:release_date_us? Release date for USA in the format yyyy-mm-dd

 

There are also specific fields for each item type:

 

Serie
Element Property Description
  ptItem:tvchannels? A list of ptItem:tvchannel with the channels on which the tv show is being (or has been) broadcasted
  ptItem:tvchannel TV channel where the show is being broadcasted. Accepts property id (the internal representation of the tv channel).

 

 

Video game
Element Property Description
  ptItem:platform The platform when the video game runs. Possible values are pc, wii, playstation3, xbox360, nintendods and psp
  ptItem:studio Development studio
  ptItem:pegi PEGI rating (3+, 7+, 12+, 16+, 18+)
  ptItem:esrb ESRB rating (E, EC, E10+, T, M, AO)
  ptItem:players Number of maximum offline players, possible values are a number from 1 to 16 or >16
  ptItem:online_players Number of maximum online players, possible values are a number from 1 to 16, >16, yes or massive.

 

 

Book
Element Property Description
  ptEditions* A collection of ptEdition entries with all the editions of the book.

 

Examples

 

Film

 

 

 

Serie

 

 

 

Video game

 

Book

 

 

Go back to Partigi API Documentation

Comments (0)

You don't have permission to comment on this page.