Ogni voce restituita dall'API Content di GoodBarber è formattata secondo un tipo generico di dizionario denominato "Item".
Le voci di tipo "Item" presentano chiavi comuni e chiavi aggiuntive specifiche a seconda del loro tipo e sottotipo.
Nell'elenco riportato di seguito, per i tipi specifici (articoli, video, ecc.) che ereditano da "Item", vengono descritte solo le chiavi aggiuntive.
Le voci di tipo "Item" presentano chiavi comuni e chiavi aggiuntive specifiche a seconda del loro tipo e sottotipo.
Nell'elenco riportato di seguito, per i tipi specifici (articoli, video, ecc.) che ereditano da "Item", vengono descritte solo le chiavi aggiuntive.
1. Item (comune)
Tipo generico “Item”; tutti gli altri tipi ereditano da “Item”.
| Nome | Tipo | Descrizione |
| id | String | Identificatore univoco dell'elemento nella sua fonte |
| type | String | Tipo di elemento |
| title | String | Titolo dell'elemento |
| url | String | URL dell'elemento nella sua fonte |
| categories | Array of Strings | Categorie associate all'elemento nella fonte |
| date | String (date) | Data di pubblicazione dell'elemento |
| author | String | Autore dell'elemento |
| subtype | String | Sottotipo dell'elemento (descrive in genere il tipo di servizio della fonte) |
2. Articolo
Ereditato da "Item", può essere visualizzato nelle sezioni "Articolo".
type = article
subtype = wordpress, typepad, wmaker, rss, etc.
type = article
subtype = wordpress, typepad, wmaker, rss, etc.
| Name | Type | Description |
| 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 | Miniatura dell'articolo (formato piccolo) |
| thumbnail | String | Miniatura dell'articolo (formato medio) |
| largeThumbnail | String | Miniatura dell'articolo (formato grande) |
| images | Array of Dict | Elenco delle immagini contenute nell'articolo |
| images/[]/id | String | Valore dell'attributo "id" dei tag <img> nel contenuto dell'articolo |
| images/[]/url | String | URL dell'immagine |
3. Foto
Ereditato da Item, può essere visualizzato nelle sezioni Foto.
type = foto
subtype = flickr, facebook, wmaker, picasa, etc.
Valori indicativi di {SIZE}
type = foto
subtype = flickr, facebook, wmaker, picasa, etc.
| Nome | Tipo | Descrizione |
| content | String | Descrizione della foto (solo testo, senza HTML) |
| nbLikes | Integer | Numero di "Mi piace" della foto (solo se sottotipo = facebook) |
| nbComments | Integer | Numero di commenti |
| commentsEnabled | Bool | Indica se i commenti devono essere abilitati o meno per questo elemento |
| commentsUrl | String | URL per accedere al feed JSON dei commenti relativi a questo elemento |
| commentsPostUrl | String | URL che consente di pubblicare commenti su questo elemento |
| images | Dict | Elenco delle diverse dimensioni disponibili per la foto |
| images/{SIZE}/height | Integer | Altezza della foto |
| images/{SIZE}/width | Integer | Larghezza della foto |
| images/{SIZE}/url | String | URL della foto |
Valori indicativi di {SIZE}
| Valore | Descrizione | Valori indicativi |
| square | Formato piccolo (quadrato) | 75x75 |
| largesquare | Formato medio (quadrato) | 150x150 |
| small | Formato ridotto (proporzioni originali) | 240x180 |
| medium | Formato medio (proporzioni originali) | 320x240 |
| large | Formato grande (proporzioni originali) | 640x480 |
4. Video
Ereditato da Item, può essere visualizzato nelle sezioni Video.
type = video
subtype = youtube, dailymotion, vimeo, wmaker, facebook, etc.
Possibili chiavi per {VIDEO_TYPE}
type = video
subtype = youtube, dailymotion, vimeo, wmaker, facebook, etc.
| Nome | Tipo | Descrizione |
| nbComments | Integer | Numero di commenti |
| commentsEnabled | Bool | Indica se i commenti devono essere abilitati o meno per questo elemento |
| commentsUrl | String | URL per accedere al feed JSON dei commenti relativi a questo elemento |
| commentsPostUrl | String | URL che consente di pubblicare commenti su questo articolo |
| content | String | Descrizione del video |
| summary | String | Sintesi del video (senza HTML, solo testo) |
| smallThumbnail | String | Miniatura del video (formato piccolo) |
| thumbnail | String | Miniatura del video (formato medio) |
| largeThumbnail | String | Miniatura del video (formato grande) |
| nbViews | Integer | Numero di visualizzazioni del video |
| length | Integer | Durata del video (secondi) |
| rating | Float | Valutazione media del video |
| nbRatings | Integer | Numero di valutazioni del video |
| videoUrls | Dict | Dizionario contenente i diversi formati della sorgente video |
| videoUrls/{VIDEO_TYPE} | String | URL della risorsa video corrispondente a {VIDEO_TYPE} |
| videoUrl | String | URL per guardare il video (solo se subtype = facebook) |
| nbLikes | Integer | Numero di "Mi piace" del video (solo se subtype = facebook) |
| image | String | URL della miniatura originale del video (solo se subtype = facebook) |
Possibili chiavi per {VIDEO_TYPE}
| Valore | Descrizione | Formato |
| m3u8 | URL del feed di streaming HTTP | Apple HTTP Streaming |
| mp4 | URL del file MP4 | MP4 |
| embed | URL che potrebbe essere indicato come fonte di un codice HTML incorporato per guardare il video | HTML embed |
| embedHTML | Codice HTML completo per l'incorporamento del video | HTML embed |
5. Evento
Ereditato da "Item", può essere visualizzato nelle sezioni "Evento".
type = evento
subtype = facebook, google, wmaker, etc.
type = evento
subtype = facebook, google, wmaker, etc.
| Nome | Tipo | Descrizione |
| 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 |
6. Audio
Ereditato da Item, può essere visualizzato nelle sezioni Audio.
type = audio
subtype = podcast, soundcloud, etc.
type = audio
subtype = podcast, soundcloud, etc.
| Name | Type | Description |
| 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 |
7. Commento
Ereditato da Item, può essere visualizzato nelle pagine dei commenti.
type = commento
subtype = wordpress, wmaker, etc.
type = commento
subtype = wordpress, wmaker, etc.
| Name | Type | Description |
| content | String | Content of the comment |