Afin de protéger le fichier du client, le lien de téléchargement ne peut pas être généré d'avance et fourni tel quel au client. Les liens de téléchargement sont chrono-dégradables, et ne peuvent être obtenus que par le vendeur de la publication. Le vendeur offre donc son propre lien de téléchargement à son client, et lorsque le client utilise ce lien, le vendeur utilise le service Web ci-bas afin de rediriger son client vers le fichier.


Étapes lors de la demande de téléchargement:

  1. L'utilisateur clique sur le lien qui lui a été fourni pour télécharger son livre;

  2. La page du site Web reçoit la demande de téléchargement, retrace les informations afin de construire l'URL du service Web Obtention du lien de téléchargement d'une publication, et utilise ce service Web. Elle reçoit en retour une URL de téléchargement chronodégradable;

  3. La page intermédiaire du site Web redirige automatiquement et instantanément l'utilisateur vers l'URL de téléchargement chronodégradable reçue;

  4. Le téléchargement démarre.


Déclaration

Adresse :

/api/organisations/[organisation_id]/customers/[customer_id]/transactions/[transaction_id]/publications/[isbn]/download_links/[format]

Méthode : GET

Sécurité : HTTP/BASIC (Nom d'utilisateur et mot de passe)


Paramètres

organisation_id :  (Obligatoire)

Numéro d'organisation. Fourni lors de l'inscription.


customer_id :  (Obligatoire)

Le numéro du client.


transaction_id :  (Obligatoire)

Le numéro unique de la transaction / du panier d'achat.


isbn :  (Obligatoire)

L'ISBN de la publication.


format :  (Obligatoire)

Le format de la publication vendue (pdf/epub/mobi/audio/proof).


uname :  (Obligatoire)

Prénom et nom de l'utilisateur. La valeur de ce paramètre apparaîtra dans le texte du filigrane qui sera apposé sur le fichier.


Réponses

200 : OK

URL chronodégradable du fichier à télécharger (expiration : 1 minute). Redirigez l'utilisateur vers cette


400 : missing_transaction_id

Le numéro de transaction était absent de la requête.


401 : access_denied

Accès refusé à la ressource.


404 : not_found

L'organisation n'a pu être trouvée.