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>
<customer>
<id>customer_id</id></customer>
<publications><publication>
<format>
<nature>epub</nature>
<keytype>isbn</keytype>
<value>9782896157181</value>
<protectiontype>watermark</protectiontype></format>
<fulfillment>complete</fulfillment>
<refundable>false</refundable></publication>
</publications></transaction>
</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.