Indice

  1. Aggiornamento catalogo

    1. Creazione file di aggiornamento
    2. Recupero file XML o Onix
    3. Verifica dei metadati relativi alla pubblicazione
  2. Vendita e download di pubblicazioni

    1. Simulazione di vendita
    2. Vendita di una pubblicazione
    3. Download di una pubblicazione
  3. Procedura da seguire per la sincronizzazione del catalogo.

  4. Allegato 1. Immagine della copertina

  5. Allegato 2. Il DRM (Digital Rights Management) ACS4 (Adobe Content Server 4)

Introduzione

Questa guida è destinata alle librerie, case editrici o altri venditori interessati ad offrire la vendita e il download di ebook sul loro sito. I web service presentati in questo documento permettono di eseguire due operazioni fondamentali:

  1. ottenere la lista dei titoli disponibili per creare il tuo catalogo e rimanere informato dei cambiamenti e delle aggiunte fatti al catalogo di the electronic books distribution platform Edigita.
  2. registrare una vendita in Edigita per dare all'utente la possibilità di scaricare il suo ebook.

Il primo web service serve a sviluppare uno strumento che sincronizza automaticamente, ogni 24 ore, il tuo catalogo con quello offerto su Edigita, utilizzando un flusso di dati (XML o Onix). Vedi dettagli al punto 1. Aggiornamento catalogo.

Il secondo serve ad integrare nel tuo processo di acquisto, le chiamate ai web service di vendita ebook e a fornire all'utente, in seguito ad un acquisto, un link per il download. Vedi la sezione 2. Vendita e download pubblicazioni.

Note generali

Convenzione sul formato della data

Per tutti i web service, la data, quando è richiesta, deve essere fornita in formato ISO 8601 Basic. Per esempio:

  1. Il 12 luglio 2010 = 20100712
  2. Il 12 luglio 2010 alle 17:30 = 20100712R173000
ISBN

Gli ebook hanno un ISBN diverso dai libri in formato cartaceo.

Integrazione del collegamento allo sfoglialibro ed altre opzioni offerte da Edigita.

La guida Integrazione sito web (edigita.cantook.net/admin/guides/bridge) ti spiega come integrare nel tuo sito un pulsante che compare in modo automatico quando lo sfoglialibro è disponibile per la pubblicazione visualizzata (a prescindere se il libro è in formato cartaceo o digitale). Vedi le sezioni 1.1, 1.2 e 2.1 per sapere come integrare questo collegamento automatico.

Sono disponibili anche altre opzioni nella guida online come l'integrazione di uno sfoglialibro (flipbook) direttamente nella pagina (2.3) o di un pulsante per scaricare un estratto dalla pubblicazione in formato PDF (2.5).

 

1 : Aggiornamento catalogo

I seguenti web service permettono di fare l'aggiornamento quotidiano del tuo catalogo ebook e di recuperare automaticamente tutte le modifiche fatte dall'ultima sincronizzazione (o da una data specifica). Per motivi di prestazioni del server, la lista delle modifiche è divisa in diversi file che contengono ognuno un massimo di 50 titoli aggiornati.

Due web service sono dedicati: il primo permette di creare i frammenti (file) sul server e di restituire una lista di URL per ognuno di questi frammenti. Il secondo web service permette di chiamare ogni URL (uno dopo l'altro) della lista per recuperare i file da processare nel tuo sistema per aggiornare il tuo catalogo.

Fasi:
  1. Chiamata al web service Creazione file di aggiornamento (1.1);
  2. Ricezione lista di URL dei file XML o Onix;
  3. Chiamata URL della lista per scaricare il file (1.2) e processarlo.

Leggi la Procedura per la sincronizzazione del catalogo (vedi punto 3) per maggiori dettagli.

 

1.1 : Creazione file di aggiornamento

Questo web service permette di fare creare sulla piattaforma dei file XML o ONIX di aggiornamento catalogo. Il web service ti restituirà una lista di URL indirizzati a questi file XML, in modo da poterli scaricare. Saranno visualizzate solo le pubblicazioni che sono state aggiunte, modificate o eliminate.

  • Vedi la descrizione dettagliata dei tag XML: http://edigita.cantook.net/admin/guides/bridge (Allegato 2)
  • Vedi un esempio del formato XML: http://edigita.cantook.net/documents/guides/importation.xml
Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/publications/lists
Formati xml, onix
Metodo POST
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
reset_at No Data in formato ISO 8601 Basic. Se incluso nella richiesta, tutte le modifiche avvenute dopo questa data/ora ti saranno inviate.
format No Valori possibili: onix, xml. Il valore di default è "xml".
Risposte
Codice Contenuto Descrizione
201 0 a X url La lista è stata creata con successo. Il corpo della risposta conterrà un vettore di URL. Vedi la descrizione nella sezione 1 e il web service 1.2 per maggiori dettagli.
401 access_denied Non hai accesso alla risorsa.
404 not_found La tua organizzazione non è stata trovata.
415 invalid_format Il formato richiesto non è supportato.
415 invalid_date La data specificata in reset_at non è corretta.
 

1.2 : Recupero file XML o Onix

Il web service 1.1 (Creazione file di aggiornamento) restituisce una lista di URL. Basta chiamare questi URL per scaricare il flusso XML o Onix. Questo file può essere processato nel tuo sistema per aggiornare il tuo catalogo. Segue la descrizione dettagliata del fomato di questi URL.

Non sarà mai necessario generare questi indirizzi. Saranno sempre forniti dal web service 1.1 (Creazione file di aggiornamento).

Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/publications/lists/[list_id].[xml|onix]
Formati xml, onix
Metodo GET
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
list_id Si Identificatore della lista.
Risposte
Codice Contenuto Descrizione
200 text/xml Flusso XML delle pubblicazioni.
401 access_denied Non hai accesso alla risorsa.
404 not_found La tua organizzazione non è stata trovata.
 

1.3 : Verifica dei metadati relativi alla pubblicazione

Questo web service permette di ricevere tutti i metadati relativi ad una pubblicazione specifica. Per esempio, puoi utilizzarlo in ogni momento per controllare che i tuoi dati siano corretti.

Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/publications/[isbn].[xml|onix]
Formati xml, onix
Metodo GET
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
isbn Si ISBN/EAN della pubblicazione
Risposte
Codice Contenuto Descrizione
200 text/xml Flusso XML della pubblicazione.
401 access_denied Non hai accesso alla risorsa.
404 not_found La pubblicazione non è stata trovata.
 

2 : Vendita e download di pubblicazioni

I web service della piattaforma sono utilizzati in due momenti distinti: quando una pubblicazione è venduta (2.1) e quando è scaricata (2.2). Acquisto e download sono due processi separati che sono compiuti in due istanti diversi: un utente può acquistare un libro una volta ma lo può scaricare più volte in modo del tutto gratuito. Allo stesso tempo, un libro che è già stato acquistato qualora venga nuovamente scaricato non viene registrato come venduto ulteriormente.

I passi da seguire in caso di vendita di un libro sono:
  1. Quando l'utente aggiunge un libro nel suo carrello, utilizza il web service Simulazione di vendita per determinare se il libro è disponibile.
  2. Quando l'utente conferma l'acquisto (e ha inserito gli estremi del pagamento)
    1. Utilizza il web service Simulazione di vendita per determinare se il libro è disponibile.
    2. Se il codice di risposta del server è 200 (valid), procedi al pagamento.
    3. Se il pagamento è accettato dall'istituto bancario, registra la vendita sulla piattaforma utilizzando il web service Vendita di una pubblicazione.
  3. Se il codice di risposta del web service di vendita è 201 (“created”), visualizza una pagina di conferma di acquisto e/o invia una mail di conferma dell'acquisto all'utente. La mail di conferma contiene un link per il download del libro.
  4. Il link per il download fornito all'utente deve puntare ad una pagina temporanea del tuo sito web. Il compito di questa pagina è di chiamare il web service Download di una pubblicazione e di reindirizzare il browser del cliente sull'URL ricevuto.

Si consiglia di aggiungere nel tuo sito web, una sezione in cui l'utente può identificarsi e avere accesso alla cronistoria dei suoi acquisti. In questa sezione, l'utente potrebbe per esempio scaricare nuovamente il suo libro se fosse necessario. Questa opzione permette di limitare le chiamate di assistenza post-vendita.

 

2.1 : Simulazione di vendita

Questo web service permette di simulare una vendita. Dato che le informazioni presenti nel tuo catalogo sono sincronizzate quotidianamente e che dei cambiamenti sulla piattaforma possono avvenire in ogni momento, è possibile che ci siano differenze fra i due cataloghi. Questo web service verifica che tutti i parametri richiesti per registrare una vendita siano validi (prezzo, protezione) e che il titolo sia ancora disponibile per la vendita.

E' importante sempre validare il codice di risposta del server prima di passare alle fasi successive del processo di acquisto.

In questa simulazione, la vendita non viene registrata sulla piattaforma. Per registrarla è necessario utilizzare il web service Vendita di una pubblicazione.

Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/publications/[isbn]/sales/new
Metodo GET
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
isbn Si L'ISBN della pubblicazione.
format Si Il formato della pubblicazione venduta (pdf/epub/mobi/audio)
cost Si Il prezzo di vendita approssimato al centesimo (esempio: 19,99 $ => 1999)
protection Si Il tipo di protezione assegnata alla pubblicazione venduta (open/watermark/acs4/acs4_timelimited)
country No Il paese utilizzato per convalidare il prezzo della pubblicazione. Valore di default: il paese della vostra organizzazione. Formato ISO 3166-1 (can, fra, ita).
Risposte
Codice Contenuto Descrizione
200 valid La simulazione di vendita è stata eseguita con successo.
400 cannot_sell Non puoi vendere questa pubblicazione.
400 missing_isbn Non hai inserito l'ISBN.
400 missing_format Non hai inserito il formato.
400 invalid_format Il formato fornito non è disponibile per questa pubblicazione.
400 missing_cost Non hai inserito il prezzo.
400 invalid_cost Il prezzo non corrisponde al prezzo inserito nella piattaforma.
400 missing_protection Non hai inserito il tipo di protezione.
400 invalid_protection Questo tipo di protezione non è disponibile per questo formato.
401 access_denied Non hai accesso alla risorsa.
404 not_found La tua organizzazione non è stata trovata.

Nel caso di un errore di tipo 400, ti sarà inviato un vettore contenendo i tipi di errori.

Qualora i tuoi dati non fossero sincronizzati con quelli della piattaforma (errori che iniziano con "invalid_"), è possibile farlo direttamente con il web service 1.3. Sarà comunque necessario informare gli utenti delle modifiche effettuate.

 

2.2 : Vendita di una pubblicazione

Questo web service permette di registrare la vendita sulla piattaforma. La vendita registrata associa una transazione fatta in una data con il negozio, l'utente e il libro. La registrazione della vendita è necessaria per permettere all'utente di accedere al download del suo libro. L'editore può vedere i dettagli della vendita nelle statistiche della piattaforma mentre il negozio riceve una fattura da parte dell'editore per la sua quota parte.

E' importante sempre validare il codice di risposta del server durante la chiamata al web service. Il web service di download (2.2) non va utilizzato se il codice di risposta del server non è 201 "success".

Una volta completata la vendita, devi salvare nel tuo sistema le impostazioni che sono state utilizzate. Saranno necessarie per generare il link per il download.

Prova di vendita

Per fare una prova di vendita (ad esempio, durante lo sviluppo della connessione al web service), è sufficiente che il parametro "transaction_id" inizi con un punto esclamativo "!". In questo modo, il download funziona ma la vendita non appare nelle statistiche e non è registrata dall'editore.

Libri campioni

Dei libri campioni sono messi a tua disposizione. Usali per i test in modo da avere libri leggeri e rapidamente accessibili. I libri campioni non possono essere venduti nel tuo negozio online.

  1. Titolo: test-1. Formato PDF: 9990000000001 Formato ePub: 9991000000001 protezione: Watermark (“protection=watermark”) costo: 0$, 0 euro (“cost=0”)
  2. Titolo: test-2. Formato PDF: 9990000000002 Formato ePub: 9991000000002 protezione: ACS4 (“protection=acs4”) costo: 1,00$, 1.00 euro (“cost=100”)
  3. Titolo: test-3. Formato PDF: 9990000000003 Formato ePub: 9991000000003 protezione: ACS4 (“protection=acs4”) costo: 0$, 0 euro (“cost=0”)
Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/publications/[isbn]/sales
Metodo POST
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
isbn Si L'ISBN della pubblicazione
format Si Il formato della pubblicazione venduta (pdf/epub/mobi/audio).
cost Si Il prezzo di vendita approssimato al centesimo (esempio: 19,99 $ => 1999)
protection Si Il tipo di protezione assegnata alla pubblicazione venduta (open/watermark/acs4/acs4_timelimited).
customer_id Si Il numero univoco del tuo cliente. Solo caratteri alfanumerici ("-" e "_" accettati).
transaction_id Si Il numero univoco di transazione/ carrello. E' possibile aggiungere più vendite allo stesso numero di transazione però queste devono essere associate ad un unico utente. Solo caratteri alfanumerici (sono consentiti "-" e "_").
credit_card_prefix No I primi 4 numeri della carta di credito del cliente. L'editore in base a questi caratteri può identificare il luogo di vendita.
sale_state No Lo stato della vendita. Di default una vendita è sempre "active" ma può essere in stato "test" cambiando questo parametro. Valori possibili: active, test
country No Il paese utilizzato per convalidare il prezzo della pubblicazione. Valore di default: il paese della vostra organizzazione. Formato ISO 3166-1 (can, fra, ita)
aggregator No  
Risposte
Codice Contenuto Descrizione
201 created La vendita è stata aggiunta con successo.
400 cannot_sell Non puoi vendere questa pubblicazione.
400 missing_isbn Non hai inserito l'ISBN.
400 missing_format Non hai inserito il formato.
400 invalid_format Il formato fornito non è disponibile per questa pubblicazione.
400 missing_cost Non hai inserito un prezzo.
400 invalid_cost Il prezzo non corrisponde al prezzo inserito nella piattaforma.
400 missing_customer_id Non hai inserito il numero univoco del tuo cliente.
400 missing_transaction_id Non hai inserito il numero univoco di transazione.
400 missing_protection Non hai inserito il tipo di protezione.
400 invalid_protection Questo tipo di protezione non è disponibile per questo formato.
400 invalid_sale_state Lo stato di vendita non è valido
401 access_denied Non hai accesso alla risorsa.
404 not_found La tua organizzazione non è stata trovata

Nel caso di un errore di tipo 400, ti sarà inviato un vettore contenente i tipi di errori.

Qualora i tuoi dati non fossero aggiornati con quelli della piattaforma (errori che iniziano con "invalid_"), è possibile farlo direttamente con il web service 1.3. Sarà comunque necessario informare gli utenti delle modifiche effettuate.

 

2.3 : Download di una pubblicazione

Il link per il download richiede una pagina intermedia sul tuo sito. Questa pagina utilizza un web service e reindirizza sull'URL finale per il download. Avendo una durata limitata, l'URL non può essere visualizzato su una pagina o in una mail di conferma di acquisto. La pagina intermedia permette di avere un link per il download sempre aggiornato. Il reindirizzamento richiede pochi istanti, il periodo di validità del link sarà sufficiente per fare entrambe le fasi.

Il link fornito nella pagina di conferma di acquisto o nella mail deve chiamare il tuo sito web. Quando l'utente clicca su questo link, il tuo sistema riceve la richiesta e individua tutti i parametri necessari al web service 2.3 descritto sotto (i valori dei parametri devono essere identici ai valori utilizzati nel web service di vendita 2.2). Il tuo sistema quindi utilizza il web service 2.3, e riceve il link a scadenza per il download. Il tuo sistema reindirizza poi automaticamente il browser del client sull'URL a scadenza.

Fasi durante la richiesta di download:
  1. L'utente clicca sul link che gli hai fornito per scaricare il libro (a partire dalla conferma di acquisto o dalla mail);
  2. La pagina intermedia del tuo sito web riceve la richiesta di download, rintraccia le informazioni per creare l'URL del web service Download di una pubblicazione e utilizza quel web service. Riceve come risposta un URL a scadenza per il download;
  3. La pagina intermedia del tuo sito web reindirizza automaticamente e istantaneamente l'utente sull'URL a scadenza;
  4. Il download inizia.

Il link dato al cliente deve contenere informazioni sufficienti per poter rintracciare nel tuo sistema tutti i parametri necessari nel web service.

Indirizzo https://edigita.cantook.net/api/organisations/[organisation_id]/customers/[customer_id] /transactions/[transaction_id]/publications/[isbn]/download_links/[format]
Metodo GET
Security HTTP/BASIC (Usa il tuo nome utente e password)
Parametri
Nome Obbligatorio Descrizione
organisation_id Si Il tuo numero venditore. Questo numero ti è fornito al momento della registrazione.
customer_id Si Il numero del tuo cliente
transaction_id Si Il numero univoco di transazione/ carrello.
isbn Si L'ISBN della pubblicazione.
format Si Il formato della pubblicazione venduta (pdf/epub/mobi/audio).
uname Si Nome e cognome dell'utente. Richiesto se la pubblicazione è protetta da watermark. Il valore di questo parametro compare nel testo in filigrana immesso sul file.
Risposte
Codice Contenuto Descrizione
200 url URL a scadenza del file da scaricare (scadenza: 1 minuto). Reindirizza l'utente su questo URL.
400 missing_transaction_id Non hai inserito un numero di transazione
401 access_denied Non hai accesso alla risorsa.
404 not_found La tua organizzazione non è stata trovata.
 

3 : Procedura da seguire per la sincronizzazione del catalogo.

La piattaforma fornisce un flusso di dati per aggiornare il tuo catalogo. E' necessario fare aggiornamenti giornalieri al fine di evitare differenze tra i due cataloghi. Aggiornamenti e modifiche al catalogo the electronic books distribution platform Edigita possono verificarsi giornalmente in qualsiasi momento.

Quando un nuovo libro è creato o quando delle informazioni relative ad una pubblicazione cambiano, la descrizione ti è inviata nel flusso dei dati.

E' possibile utilizzare l'ISBN che si trova nel flusso come chiave univoca, per controllare se la pubblicazione è già stata inserita nel catalogo.

Prima di aggiungere o aggiornare un titolo in catalogo, certi controlli devono essere eseguiti.

  • Controllo 1. La pubblicazione è nuova, modificata o eliminata?
  • Controllo 2. Il formato digitale della pubblicazione è o non è disponibile per la vendita?
  • Controllo 3. I formati disponibili per la vendita hanno un prezzo?
Controllo 1: Pubblicazione Online/ Da eliminare?

Il flusso dei dati può contenere titoli che sono Online o Da eliminare. Controlla il valore dei tag successivi per eseguire l'azione appropriata. Attenzione, quando una pubblicazione è Online potrebbe non essere disponibile per la vendita (vedi sotto Formato di pubblicazione disponibile o no per la vendita). Quando una pubblicazione è da eliminare, è necessario rimuoverla dal catalogo, in modo che i visitatori del tuo sito web non la possano comprare.

XML
<publication>
...
<state>created</state>
il titolo è stato creato. AZIONE: procedere con i controlli successivi.
<state>updated</state>

questo titolo è stato aggiornato. AZIONE:procedere con i controlli successivi.
<state>deleted</state>
questo titolo non è più disponibile. AZIONE: rimuoverlo dal catalogo.
...
</publication>
ONIX
<Product>

...
<NotificationType>03</NotificationType>
AZIONE: procedere con i controlli successivi.
<NotificationType>04</NotificationType>
AZIONE: aggiornare la pubblicazione nel catalogo
<NotificationType>05</NotificationType>

AZIONE: rimuoverlo dal catalogo.
...
</Product>
Controllo 2: Formato della pubblicazione disponibile per la vendita?

I titoli possono essere disponibili in uno o più formati (PDF, ePub, Mobi, Audio) e ogni formato può indipendentemente essere disponibile o no per la vendita. Controlla il valore dei tag successivi per eseguire l'azione appropriata. Quando una pubblicazione è disponibile per la vendita, è necessario procedere con i controlli successivi prima di aggiungere il titolo in catalogo. Quando la pubblicazione non è disponibile per la vendita, è necessario rimuoverla dal catalogo, in modo che i visitatori del tuo sito web non la possano comprare.

XML
<publication>
...
<formats>
<format>
...
<state>sell</state>

questo titolo è in vendita. AZIONE: procedere con i controlli successivi.
<state>view</state>
questo titolo non è in vendita. AZIONE: rimuoverlo dal catalogo.
...
</format>
</formats>
...
</publication>
ONIX
<Product>
...
<SalesRightType>01</SalesRightType>
questo titolo è disponibile per la vendita. AZIONE: procedere con i controlli successivi.
<SalesRightType>03</SalesRightType>
questo titolo non è disponibile per la vendita
AZIONE: rimuoverlo dal catalogo (se era già dentro).
...

</Product>
Controllo 3: I formati disponibili per la vendita devono avere un prezzo.

Ogni formato dell'ebook può avere un prezzo specifico. Prima di aggiungere un ebook al tuo catalogo, controlla che abbia un prezzo al dettaglio suggerito nella valuta desiderata. Se l'ebook non ha un prezzo, non lo pubblicare nel tuo catalogo.

XML
<publication>
...
<formats>
<format>
...
<costs>
<cost>

<amount></amount>
Importo del prezzo al dettaglio suggerito
<currency></currency>
Valuta del prezzo al dettaglio suggerito
<region></region>
Regione associata alla valuta (canada, europa)
...
<cost>

<costs>
...
</format>
</formats>
...
</publication>
ONIX
<Product>
...
<SupplyDetail>
<Price>
<CountryCode></CountryCode>
Il codice ISO 3166-1 del paese (2 caratteri) per il quale è valido il prezzo.
<PriceAmount></PriceAmount>

Importo del prezzo al dettaglio suggerito
</Price>
</SupplyDetail>
...
</Product>
Crea/ Aggiorna l'elemento in catalogo

Quando un nuovo libro è creato o quando delle informazioni relative ad una pubblicazione cambiano, la descrizione ti è inviata nel flusso dei dati. In quel caso, l'informazione che è stata modificata non è isolata o identificata nel flusso. I campi da salvare o da aggiornare nel tuo catalogo sono:

  • il titolo
  • l'ISBN
  • il formato
  • il prezzo
  • la protezione
  • il nome dell'editore
  • la descrizione
  • il nome dell'autore
  • l'immagine della copertina da riscaricare ad ogni avviso di modifica (vedi Allegato 1. Immagine di copertina)
  • Vedi la descrizione dettagliata dei tag XML: http://edigita.cantook.net/admin/guides/bridge (Allegato 2)
  • Vedi un esempio di XML: http://edigita.cantook.net/documents/guides/importation.xml
 

Allegato 1. Immagine della copertina

Due immagini della copertina sono disponibili.

L'immagine fornita dall'editore

Se l'immagine della copertina è stata fornita dall'editore, si ritrova descritta nel flusso dei metadati, nella sezione (XML) o (Onix). Un URL ti sarà fornito per il download.

L'immagine estratta automaticamente a partire dalla prima pagina del file PDF

Se l'editore ha fornito un PDF, un'immagine della copertina è automaticamente estratta dal file. Questa immagine è disponibile in formato JPG in 3 dimensioni. E' resa pubblica sul server e basta usare uno dei seguenti URL per accederci, in base al formato desiderato.

  1. Piccolo (65px) : http://edigita.cantook.net/images/publications/{ID_PUBLICATION}/cover/small.jpg
  2. Medio (200px) : http://edigita.cantook.net/images/publications/{ID_PUBLICATION}/cover/medium.jpg
  3. Grande (1000px) : http://edigita.cantook.net/images/publications/{ID_PUBLICATION}/cover/large.jpg

{ID_PUBLICATION} corrisponde alla parte numerica dell'identificatore della pubblicazione. La trovi nel flusso XML sotto o nel flusso Onix sotto .

 

Allegato 2. Il DRM (Digital Rights Management) ACS4 (Adobe Content Server 4)

Quando il formato dell'ebook è protetto da DRM ACS4 (vedi tag acs4 nel flusso XML), è consigliabile visualizzare alcune informazioni nella pagina di dettaglio relativa a questo elemento, nel catalogo:

  1. il file è protetto da DRM Adobe Content Server 4,
  2. il suo uso è limitato (il numero di attivazioni su dispositivi è imposto da Adobe: 6)
  3. il suo uso può essere limitato (copia incolla o stampa del contenuto)
  4. il DRM ACS4 non è compatibile con tutti i dispositivi di lettura
  5. l'utente deve installare il software Adobe Digital Editions (gratis)
  6. l'utente deve crearsi un account Adobe ID (gratis)

Tutto questo può anche essere spiegato in una sezione Aiuto o FAQ del tuo sito web.