API d'état d'un téléchargement
Ce service permet d'obtenir une confirmation de la bonne réception d'un téléchargement par le client.
Déclaration
Adresse : /api/organisations/{organisation_id}/customers/{customer_id}/transactions/{transaction_id}/publications/{isbn}/formats/{format}/status
Paramètres
L'ensemble des paramètres de l'appel sont les mêmes que ceux des services Web de ventes.
Réponse
La réponse prendra la forme suivante:
<status>
<transaction><id>transaction_id</id></transaction>
<customer>
<id>customer_id</id></customer>
<publications><publication></publication><format><fulfillment>complete</fulfillment><nature>epub</nature></format>
<keytype>isbn</keytype>
<value>9782896157181</value>
<protectiontype>watermark</protectiontype>
<refundable>false</refundable>
</publications>
</status>
Notes
La balise <fulfillment> vous indique l'état du téléchargement du fichier par le client:
- dans le cas d'une protection par filigrane (watermark): complete et incomplete font référence au démarrage du téléchargement du fichier
- dans le cas d'une protection par DRM (ACS4): complete et incomplete font référence à l'activation de la licence du livre dans Adobe Digital Edition ou dans un autre logiciel compatible.
Les autres balises correspondent aux informations fournies lors de l'appel au service.