Item types documentation

Cada entrada retornada pela API de Conteúdo da GoodBarber é formatada em um dicionário genérico do tipo Item.

As entradas do tipo Item possuem chaves comuns e chaves adicionais específicas de acordo com seu tipo e subtipo.

Na lista abaixo, para os tipos específicos (artigos, vídeos, etc.) herdados de Item, estão descritas apenas as chaves adicionais.

O tipo Item é genérico; todos os outros tipos herdam de Item.
 

Nome	Tipo	Descrição
id	String	Item unique identifier on its source
type	String	Item type
title	String	Item title
url	String	Item URL on its source
categories	Array of Strings	Categories associated with the item on the source
date	String (date)	Item publication date
author	String	Item author
subtype	String	Item subtype (generally describes the service type of the source)

Herdado de Item, pode ser exibido nas seções de Artigo.
tipo = artigo
subtipo = wordpress, typepad, wmaker, rss, etc.
 

Nome	Tipo	Descrição
nbComments	Integer	Number of comments associated with the item on its source
commentsEnabled	Bool	Describes if the comments have to be enabled or not for this item
commentsUrl	String	URL to access the JSON feed of comments for this item
commentsPostUrl	String	URL that allows to post comments on this item
summary	String	Summary of the article (no HTML, text only)
content	String	Article content
smallThumbnail	String	Article thumbnail (small format)
thumbnail	String	Article thumbnail (medium format)
largeThumbnail	String	Article thumbnail (big format)
images	Array of Dict	List of images contained in the article
images/[]/id	String	Value of the id attribute of the <img> tags in article content
images/[]/url	String	Image URL

Herdado de Item, pode ser exibido nas seções de Fotos.
tipo = foto
subtipo = flickr, facebook, wmaker, picasa, etc.
 

Nome	Tipo	Descrição
content	String	Photo description (text only, no HTML)
nbLikes	Integer	Number of likes of the photo (only if subtype = facebook)
nbComments	Integer	Number of comments
commentsEnabled	Bool	Describes if the comments have to be enabled or not for this item
commentsUrl	String	URL to access the JSON feed of comments for this item
commentsPostUrl	String	URL that allows to post comments on this item
images	Dict	Dictionary of the different sizes available for the photo
images/{SIZE}/height	Integer	Height of the photo
images/{SIZE}/width	Integer	Width of the photo
images/{SIZE}/url	String	URL of the photo

Valores indicativos de {SIZE} 

Valor	Descrição	Valores indicativos
square	Small format (square)	75x75
largesquare	Medium format (square)	150x150
small	Small format (original proportions)	240x180
medium	Medium format (original proportions)	320x240
large	Big format (original proportions)	640x480

Herdado de Item, pode ser exibido em seções de Vídeo.
tipo = vídeo
subtipo = youtube, dailymotion, vimeo, wmaker, facebook, etc.
 

Nome	Tipo	Descrição
nbComments	Integer	Number of comments
commentsEnabled	Bool	Describes if the comments have to be enabled or not for this item
commentsUrl	String	URL to access the JSON feed of comments for this item
commentsPostUrl	String	URL that allows to post comments on this item
content	String	Video description
summary	String	Summary of the video (no HTML, text only)
smallThumbnail	String	Video thumbnail (Small format)
thumbnail	String	Video thumbnail (Medium format)
largeThumbnail	String	Video thumbnail (Big format)
nbViews	Integer	Number of views of the video
length	Integer	Video duration (seconds)
rating	Float	Medium rating of the video
nbRatings	Integer	Number of ratings of the video
videoUrls	Dict	Dictionary containing the different formats for the video source
videoUrls/{VIDEO_TYPE}	String	URL of the video resource corresponding to {VIDEO_TYPE}
videoUrl	String	URL to watch the video (only if subtype = facebook)
nbLikes	Integer	Number of likes of the video (only if subtype = facebook)
image	String	Video original thumbnail URL (only if subtype = facebook)

Possíveis chaves para​ {VIDEO_TYPE}

Valor	Descrição	Formato
m3u8	URL of the HTTP Streaming feed	Apple HTTP Streaming
mp4	URL of the MP4 file	MP4
embed	URL that could be indicated as the source of an HTML embed to watch the video	HTML embed
embedHTML	HTML full embed code of the video	HTML embed

Herdado de Item, pode ser exibido nas seções de Evento.
tipo = evento
subtipo = facebook, google, wmaker, etc.
 

Nome	Tipo	Descrição
address	String	Address of the event
allDay	Bool	Describes if the event is an "all day" event
content	String	Event description
endDate	String (date)	End date of the event
latitude	String	Latitude of the event (GPS coordinates)
longitude	String	Longitude of the event (GPS coordinates)
thumbnail	String	Thumbnail of the event

Herdado de Item, pode ser exibido nas seções de Som.
tipo = som
subtipo = podcast, soundcloud, etc.
 

Nome	Tipo	Descrição
nbComments	Integer	Number of comments
commentsEnabled	Bool	Describes if the comments have to be enabled or not for this item
commentsUrl	String	URL to access the JSON feed of comments for this item
commentsPostUrl	String	URL that allows to post comments on this item
length	Integer	Duration of the podcast (seconds)
nbFavorites	Integer	Number of "favorites" by user for this song (only if subtype = soundcloud)
purchaseUrl	String	URL to buy the song
streamUrl	String	Stream URL for this podcast
summary	String	Description of this podcast
thumbnail	String	Thumbnail URL

Herdado de Item, pode ser exibido em páginas de comentários.
tipo = comentário
subtipo = wordpress, wmaker, etc.
 

Nome	Tipo	Descrição
content	String	Content of the comment