2.6 Obtaining the status of a download

This web service allows to know if the customer as downloaded a title or not.

Declaration

Address : /api/organisations/{organisation_id}/customers/{customer_id}/transactions/{transaction_id}/publications/{isbn}/formats/{format}/status

Parameters

All parameters of the URL should be the same that were used in the Sale of a publication API.

Response

The answer will be as follows:

<status>

<transaction>

<id>transaction_id</id>

<customer>

<id>customer_id</id>

</customer>

<publications>

<publication>

<format>

<nature>epub</nature>

<keytype>isbn</keytype>

<value>9780000000001</value>

<protectiontype>watermark</protectiontype>

</format>

<fulfillment>complete</fulfillment>

<refundable>false</refundable>

</publication>

</publications>

</transaction>

</status>

Notes

The <fulfillment> tag tells you the state of download by the end user:

in the case of a watermark protection: complete and incomplete refers to start downloading file

in the case of ACS4 DRM protection: complete and incomplete refers to the activation of the licence in Adobe Digital Edition or other compatible software.

The remaining tags correspond to the information provided during the call to the service.