Web Integration Services
Sunday, September 30th 2018
DMR
#Overview
You can add Digital Media Reserve (with ACS, latest edition) to your publishing & retailing workflow smoothly with the REST based APIs provided by DMR.
Digital Media Reserve is a Web-based Service that includes a Centralized Repository of eBook (EPUB/ PDF) files and the Fulfillment System of DRM protected eBooks (EPUB/ PDF/a). It is designed by Digital Media Initiatives around the latest edition of the legendry Adobe Content Server.
- Publishers upload their eBook (EPUB/ PDF) files to the Digital Media Reserve Repository.
- Publisher and Retailers integrate with Digital Media Reserve in order to sell eBooks (EPUB/ PDF) from the Digital Media Reserve catalog from their web site.
- The Retailer website and the Digital Media Reserve Server communicate using the Web Services with encrypted parameters embedded in the request XML message.
#Requirements for Integration
- Dynamic website with features - Shopping Cart and Payment Gateway in PHP, ASP or JSP with SOAP support.
- Website should be capable in calling SOAP-based Web Services and able to receive their response.
- Website should have a Static IP.
#Integration Steps
- Apply for a Digital Media Reserve Retailer account.
- Once your account is activated, you can browse and download the metadata for the available eBook catalog in XML format.
- Import the eBook metadata into your site in order to create pages for customers to purchase eBooks from your site.
- Add your retailer account details (CommerceID, RetailerID and RetailerKey) on your website which will be used at the time of calling the Web Services.
- Implement CheckAvailability Web Service in add to cart workflow to check the availability of eBook for sale.
- After a successful payment on your site, call NewTransaction Web Service in order to get the eBook file download link(s) from Digital Media Reserve, and provide the link(s) to your customer.
#Web Services
#CheckAvailability
A Retailer (identified by its Authentication Parameters) can use this Web Service to check the availability of an eBook before asking the customer to pay.
Syntax:
The SOAP Resquest, SOAP Response, SOAP Response For Error Handling, and PHP Code By PEAR-SOAP 0.12.0 is provided in the link below:
URL: https://1drv.ms/t/s!AmtWOIukI_IFhE7s66vMUGIabs5f
#NewTransaction
A Retailer (identified by its Authentication Parameters) can use this service to generate encrypted download link for given BookID, Format (epub, pdf/a) and TransactionID.
Syntax:
The SOAP Resquest, SOAP Response, SOAP Response For Error Handling, and PHP Code By PEAR-SOAP 0.12.0 is provided in the link below:
URL: https://1drv.ms/t/s!AmtWOIukI_IFhE9o2BfVZEpjJ0nN
#ReGenerateDownloadLink
A Retailer (identified by its Authentication Parameters) can use this service to regenerate encrypted download link for given eBookId and Format (epub, pdf/a) and Transaction ID.
Syntax:
The SOAP Resquest, SOAP Response, SOAP Response For Error Handling, and PHP Code By PEAR-SOAP 0.12.0 is provided in the link below:
URL: https://1drv.ms/t/s!AmtWOIukI_IFhFB-Nj3hxFhD2Qbe
#Parameters and Error Codes
URL: https://1drv.ms/w/s!AmtWOIukI_IFhFJJrBMhCx4-otJV
#Technical Support
techsupport@dmi.systems