1. Welcome to ApplicaDigital
ApplicaDigital is an initiative by PDI Consultores, designed to empower publishers, corporations, and libraries seeking the most secure and professional way to commercialize, distribute, or lend digital publications.
Our approach focuses on the secure distribution of digital content in ePUB and PDF formats, ensuring copyright protection and the integrity of your intellectual property.
1.1. Getting Started: Initial Checklist
To start using ApplicaDigital effectively, we recommend following these initial steps:
- Review your credentials: Make sure you have the access URL, username, and password provided by our team at hand.
- Familiarize yourself with the panel: Spend a few minutes exploring the different sections, starting with Available Catalog to view your publications.
- Configure default permissions: Before performing bulk uploads, visit the Permissions Configuration section. This step is crucial.
- (For developers) Download the Postman collection: If you plan to integrate ApplicaDigital through our API, we recommend downloading our Postman collection to facilitate testing.
- Consult this guide: Use the navigation menu to quickly find the information you need.
2. How to Use This Guide
This guide is designed as a complete reference resource. Use the floating navigation menu on the left to quickly jump to the section you need.
Contextual Help: The Best Experience
For maximum efficiency, we recommend your developers implement contextual help links within your ApplicaDigital platform. Each panel screen can include a help icon (?) that links directly to the relevant section of this guide (using section identifiers like #upload-books). This provides instant answers to your users right where they need them.
3. Technology Used
The platform uses Adobe Content Server (ACS), the reference technology in digital rights management (DRM). ACS allows secure distribution of eBooks and documents in PDF, ePUB, ePUB2, and ePUB3 formats through the most robust encryption on the market.
Once protected, files are compatible with the Adobe ecosystem, primarily through the free viewer Adobe Digital Editions (ADE), ensuring a standardized and reliable user experience.
4. Panel Usage Guide
4.1. Access and Test Environment
To access the panel, use the credentials (URL, username, and password) provided by our support team: soporte@applicadigital.com.
4.2. Available Catalog
This is the main view of your panel. It displays all your encrypted publications, allowing you to manage your digital inventory at a glance.
4.3. Upload and Update Books
This section allows you to add new publications to your catalog or modify existing ones.
4.4. View Downloads
Records each time an end user opens a protected book for the first time. This screen is your audit and support tool.
4.5. File History
Shows a detailed log of all operations performed on a file: upload, update, deletion, and the result of each process.
4.6. Permissions Configuration
This is where default permissions are defined that will be applied in bulk uploads. It is a key section for automating your workflow. It is highly recommended to review and understand each available permission option to ensure your publications are distributed according to your specific needs.
(Consider adding a detailed table or breakdown list of all available permissions and their implications here.)
5. API Documentation
Our REST API allows you to automate every aspect of publication management, integrating ApplicaDigital directly with your ecommerce, ERP, or management system.
Test the API Easily with Postman
To facilitate testing and integration, we recommend using Postman, the standard tool for API developers. We have prepared a collection with all endpoints ready to use.
Download Postman Collection5.1. Access and Authentication
To get started, generate your credentials in Configuration → API Access. All requests must use Basic Authentication and be of type POST.
5.2. Endpoint: getCatalog
Retrieves your publication catalog.
<request>
<catalogType>resume-xml</catalogType>
</request>5.3. Endpoint: getDownloadLink
Generates the download link (.acsm file) for an end user.
<request>
<typeID>uuid</typeID>
<bookID>urn:uuid:12345-abcde-67890</bookID>
<transID>SALE-2025-4567</transID>
<transType>buy</transType>
</request>5.4. Endpoint: getDownloads
Queries the download log.
<request>
<searchType>bytransid</searchType>
<transid>SALE-2025-4567</transid>
</request>5.5. Endpoint: addBook
Uploads and encrypts a new book programmatically. The Content-Type must be multipart/form-data.
Consult the complete Postman documentation to see an example of this request.
5.6. Endpoint: updateBook
Updates an existing book. Requires an additional mandatory parameter: uuid, which must contain the book's ResourceID.
Consult the complete Postman documentation to see an example of this request.
Quick API Summary
For a quick reference of all endpoints and their parameters, you can consult the following summary.
Have questions about the API or found an error? Contact our support team.
6. Common Troubleshooting
- Why does my bulk upload or FTP upload fail?
- The most common cause is not having configured the "Default Permissions" in the Configuration panel. This is a mandatory step for bulk uploads.
- A customer says they cannot download a book. What do I do?
- Go to "View Downloads" and search by their purchase transaction ID. You will be able to verify if the link was already used, from which IP, and on what date. This will give you all the information to assist them.
- I have updated a book, but my customers still see the old version.
- Updates only apply to new downloads. A user who already had the book on their device will keep the original version. To force the update, they would need to delete their local copy and download it again.
7. Glossary of Terms
| Term | Description |
|---|---|
| Creator | Author of the publication. Obtained from the upload form or from metadata embedded in the ePUB/PDF file. |
| Quantity | This permission, applicable to the Loan group, establishes the maximum number of simultaneous users who can have the book on loan. It is recommended to use it together with the "Early return" permission. |
| Early Return | This permission allows the user, from their device, to return the book before the loan period expires. Can only be used in the Loan permissions group. |
| For (days) | Enables reading for a specific number of days from the first download. Can be combined with the "Until date" permission. |
| Until (date) | Enables reading until a specific date, regardless of download date. Can be combined with the "Duration in days" permission. |
| Resource ID | A unique identifier designated by Adobe Content Server. It is the internal "license plate" of each publication. |
| ISBN | (International Standard Book Number). Obtained from the upload form. If not specified, the name of the file uploaded to the platform will be used. |
| Read/Display | Basic permission that allows the user to download and open the book on their device. It is mandatory for any permissions group. |
| Play | Enables text-to-speech on devices that have this function installed/enabled. |
| Uploaded (date) | Shows the upload date of the book to the platform. In case of an update, the most recent date will be shown. |
| Sell Type | Shows the permissions designated during encryption. Possible values are Buy, Loan, and Both (Buy and Loan). |