Lettura News

Recupero dell'elenco delle news

Risponde a richieste GET verso /umbraco/news/{type}

Il parametro type indica la tipologia di news che si vuole ottenere. Attualmente sono presenti le seguenti tipologie:

• news
• novitaRistampeEFuoriCatalogo
• cambioPrezzi
• campagne
• inPrimoPiano

È possibile passare in query string i seguenti parametri opzionali: 

• homepage: filtro sulla presenza o meno della news in homepage, di tipo boolean (true / false)
• dateFrom: filtro sulla data della news, di tipo date (es. 2021-01-25, restituisce solo le news con data maggiore o uguale del valore indicato)
• dateTo: filtro sulla data della news, di tipo date (es. 2021-01-25, restituisce solo le news con data minore o uguale del valore indicato)
• createdAfter: filtro sulla data di creazione della news, di tipo datetime (es. 2021-01-25T15:04:12.103Z, restituisce solo le news con data maggiore del valore indicato, considerando anche il fuso orario specificato)
• updatedAfter: filtro sulla data di modifica della news, di tipo datetime (es. 2021-01-25T15:04:12.103Z, restituisce solo le news con data maggiore del valore indicato, considerando anche il fuso orario specificato)
• fromId: filtro sull'ID della news, di tipo int (restituisce solo le news con ID maggiore del valore indicato)
• orderBy: ordinamento dei risultati, accetta i seguenti valori:
• id: ordinamento decrescente per ID news
• date: ordinamento decrescente per data news
• createDate: ordinamento decrescente per data di creazione della news
• updateDate: ordinamento decrescente per data di modifica della news
• maxResults: numero massimo di risultati da ottenere, di tipo int

L’operazione restituisce uno o più oggetti JSON contenenti i seguenti campi: 

• id: ID della news, di tipo int
• url: URL della news (riporta solo l'URL relativo rispetto al portale MeLi)
• createDate: data di creazione della news, di tipo datetime (es. 2021-01-25T15:04:12.103Z)
• updateDate: data di ultma modifica della news, di tipo datetime (es. 2021-01-25T15:04:12.103Z)
• creatorName: nome dell'utente che ha creato la news
• homepage: indica se la news è evidenziata in homepage, di tipo boolean (true / false)
• raccontaMeLi: indica se la news è pubblicata nella pagina "Racconta MeLi", di tipo boolean (true / false)
• date: data della news, di tipo date (es. 2021-01-25)
• title: titolo della news
• subtitle: sottotitolo della news
• content: testo della news (in formato HTML)
• linkTitle: titolo del link allegato alla news
• linkUrl: URL del link allegato alla news (riporta solo l'URL relativo rispetto al portale MeLi)

Esempio richiesta

https://api.messaggerielibri.it/umbraco/news/cambioPrezzi?orderBy=updateDate&updatedAfter=2022-01-27T11:10:00Z
Authorization: Bearer [TOKEN JWT]

Esempio risposta

[
  {
    "id": 1557,
    "url": "/news/mati-editore/",
    "createDate": "2018-03-05T11:19:35Z",
    "updateDate": "2020-01-10T14:58:16Z",
    "creatorName": "Patrizia Resmini",
    "homepage": false,
    "raccontaMeLi": false,
    "date": "2018-01-19",
    "title": "Mati Editore",
    "subitle": "Termine rapporto ",
    "content": "<p>Dal <strong>1° febbraio 2018</strong>, la distribuzione dell’Editore <strong>MATI</strong> (cod. 328) non sarà più effettuata da Messaggerie Libri.</p>\r\n<p><strong>                                                                 </strong></p>\r\n<p>Saranno accettate le rese dell’Editore solo se autorizzate dalla rete vendita entro il <strong>31 gennaio 2018</strong> e pervenute entro il <strong>28 febbraio 2018</strong> presso il magazzino:</p>\r\n<p>                     </p>\r\n<p>CEVA LOGISTICS ITALIA S.r.l.</p>\r\n<p>Via Benigno Zaccagnini snc</p>\r\n<p>Modulo A4</p>\r\n<p>Località Mattellotta - Zona Industriale</p>\r\n<p>27049 Stradella (PV)</p>\r\n<p> </p>\r\n<p>Tutte le rese che perverranno successivamente a tale data saranno respinte.</p>\r\n<p><img style=\"width: 500px; height:281.6728167281673px;\" src=\"/media/1150/crm.png?width=500&amp;height=281.6728167281673\" alt=\"\" data-udi=\"umb://media/70d9759291084f95bfe7e8977ac2e0c9\" /></p>"
  },
  {
    "id": 1517,
    "url": "/news/bibi-book/",
    "createDate": "2018-03-02T11:39:38Z",
    "updateDate": "2019-10-31T15:34:55Z",
    "creatorName": "Patrizia Resmini",
    "homepage": true,
    "raccontaMeLi": false,
    "date": "2018-03-01",
    "title": "Casa Editrice Bibi Book",
    "subitle": "La distribuzione affidata a Me.Li.",
    "content": "<p>Dal 1° marzo 2018 abbiamo in distribuzione i prodotti dell’Editore <strong><a rel=\"noopener\" href=\"http://www.bibibook.it/\" target=\"_blank\">Bibi Book</a>.</strong></p>\r\n<p><strong> </strong>La promozione sarà curata dalla rete di vendita <strong>Emme Promozione New Line.</strong></p>"
  }
]

Features

Per utilizzare il metodo API è necessario possedere una o più delle seguenti features:

• NEWS_READ

altrimenti viene restituito 403 (Forbidden)

Lettura Best Seller

Recupero dell'elenco dei titoli più venduti in lingua italiana e straniera

Risponde a richieste GET verso /umbraco/bestseller

L’operazione restituisce un oggetto JSON contenenti i seguenti campi: 

• updatedOn: data di ultima modifica dei titoli più venduti, di tipo date (es. 2021-01-25)
• titles: lista dei titoli più venduti in lingua italiana. Per ogni titolo vengono esposti i seguenti campi: 
• coverUrl: URL immagine di copertina
• ean: codice EAN
• title: titolo completo del libro
• author: autore del libro
• publisher: editore del libro
• publicationDate: data di pubblicazione del libro, di tipo date (es. 2021-01-25)
• price: prezzo del libro
• foreignTitles: lista dei titoli più venduti in lingua straniera. Per ogni titolo vengono esposti i seguenti campi:
• coverUrl: URL immagine di copertina
• ean: codice EAN
• title: titolo completo del libro
• author: autore del libro
• publisher: editore del libro
• publicationDate: data di pubblicazione del libro, di tipo date (es. 2021-01-25)
• language: codice lingua
• price: prezzo del libro

Esempio richiesta

GET https://api.messaggerielibri.it/umbraco/bestseller
Authorization: Bearer [TOKEN JWT]

Esempio risposta

{
  "updatedOn": "2022-03-02",
  "titles": [
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9788831780988_0_500_0_0.jpg",
      "ean": "9788831780988",
      "title": "CANZONE DI ACHILLE",
      "author": "MILLER MADELINE",
      "publisher": "MARSILIO EDITORI",
      "publicationDate": "2018-09-04",
      "price": 11.00
    },
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9788807033193_0_500_0_0.jpg",
      "ean": "9788807033193",
      "title": "MIDDLE ENGLAND",
      "author": "COE JONATHAN",
      "publisher": "FELTRINELLI EDITORE",
      "publicationDate": "2018-11-15",
      "price": 19.00
    },
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9788867767472_0_500_0_0.jpg",
      "ean": "9788867767472",
      "title": "BAR PAPA'. STORIE MASCHIE CORRETTE AL LATTE",
      "author": "PATRIZIO COSSA",
      "publisher": "ULTRA - LIT EDIZIONI",
      "publicationDate": "2018-11-15",
      "price": 14.90
    }
  ],
  "foreignTitles": [
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9782070306022_0_500_0_0.jpg",
      "ean": "9782070306022",
      "title": "L'ETRANGER",
      "author": "CAMUS ALBERT",
      "publisher": "GALLIMARD",
      "publicationDate": "2013-01-29",
      "language": "FR",
      "price": 8.70
    },
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9780852442555_0_500_0_0.jpg",
      "ean": "9780852442555",
      "title": "THE POEMS OF NAKAHARA CHUYA",
      "author": "NAKAHARA CHUYA",
      "publisher": "GRACEWING PUBLISHING",
      "publicationDate": "2017-11-24",
      "language": "EN",
      "price": 15.31
    },
    {
      "coverUrl": "https://img.messaggerielibri.it/images/9788498381498_0_500_0_0.jpg",
      "ean": "9788498381498",
      "title": "EL PRINCIPITO",
      "author": "SAINT-EXUPERY ANTOINE",
      "publisher": "SALAMANDRA",
      "publicationDate": "2012-03-22",
      "language": "ES",
      "price": 7.50
    }
  ]
}

Features

Per utilizzare il metodo API è necessario possedere una o più delle seguenti features:

• BEST_SELLER_READ

altrimenti viene restituito 403 (Forbidden)