The Document Cloud Services SDK (DC SDK) provides APIs for creating, combining, exporting PDFs as well as text recognition (OCR). The SDK’s simple cloud-based APIs help you get up and running quickly. Once you’ve received your developer credential, download and set up one of the sample projects. After you’re familiar with the APIs, leverage the samples in your own server-side code.
Note
The DC Service’s SDK only supports server-based use cases where credentials are saved securely in a safe environment. Services SDK credentials should not be sent to untrusted environments or end user devices.
The DC Services SDK provides a trial program so that you can take a deep dive into its cool features at zero cost. Trial users get free credentials that enable processing of 5000 pages-worth of PDF actions for 6 months.
Processing is calculated based on the number of PDF actions applied to each page of a document.
Example 1:
Converting a ten-page Word document into PDF consumes 10 pages of the trial quota.
1 (Action: convert) x 10 (pages) = 10 pages of quota.
Example 2:
Running OCR on 20 pages and then combining those pages into a single PDF consumes 40 pages of the trial quota.
1 (Action: OCR) x 20 (pages) + 1 (Action: Combine) x 20 (pages) = 40 pages of quota.
This generous allowance of processing power should allow you to get up and running with the easy-to-use APIs with little investment.
Paid credentials enable a greater processing quota and require entering into a separate written agreement. To learn more, Contact Us.
Developing with the DC Service SDK requires an Adobe-provided credential. To get one, click HERE, and complete the workflow. Be sure to copy and save the credential values to a secure location.
Validity term: The certificate associated with your credential is valid for one year. However, you can simply regenerate a new credential or apply a new certificate to the current credentials from the Document Cloud developer console.
Note
During the credential creation process you’ll be asked to whether you’d like a Personalized Code Sample Download. Choosing Personalized preconfigures the samples with your credential and removes a few steps from your development setup process.
Jump start your development by bookmarking or downloading the following key resources:
This document
Java library. The Maven project contains the .jar file.
Once you complete the Getting credentials workflow, a zip file automatically downloads that contains content whose structure varies based on whether you opted to download personalized code samples. The zip file structures are as follows:
Personalized Download: A PDFServicesSDK-JavaSamples.zip contains a private.key file and an adobe-dc-services-sdk-java-samples with a preconfigured dc-services-sdk-credentials.json file.
Non Personalized Download: A PDFServicesSDK-Credentials.zip contains the private.key file and a dc-services-sdk-credentials.json file.
After downloading the zip, you can either run the samples in the zip directly, or you can replace the dc-services-sdk-credentials.json and private.key files in the sample code with those in the zip.
Example dc-services-sdk-credentials.json file
{
"client_credentials": {
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>"
},
"service_account_credentials": {
"organization_id": "<YOUR_ORGANIZATION_ID>",
"account_id": "<YOUR_TECHNICAL_ACCOUNT_ID>",
"private_key_file": "<PRIVATE_KEY_FILE_PATH>"
}
}
Install Java 8 or above.
Run javac -version
to verify your install.
Verify the JDK bin folder is included in the PATH variable (method varies by OS).
Install Maven. You may use your preferred tool; for example:
Windows: Example: Chocolatey.
Macintosh: Example:
brew install maven
.
Note
Maven uses pom.xml to fetch dc-services-sdk from the public Maven repository when running the project. The .jar automatically downloads when you build the sample project. Alternatively, you can download the dc-services-sdk.jar file, and configure your own environment.
The quickest way to get up and running is to download the personalized code samples during the Getting Credentials workflow. These samples provide everything from ready-to-run sample code, an embedded credential json file, and pre-configured connections to dependencies.
Download the sample project.
Build the sample project with Maven: mvn clean install
.
Test the sample code on the command line. Refer to the How Tos for details about running samples. Additional details also reside in the Javadoc.
If you did not choose Personalized Code Sample Download during the credential setup process:
Download the sample project.
Find and replace dc-services-sdk-credentials.json with the one present in the downloaded zip file.
Find and replace private.key with the one present in the downloaded zip file.
Build the sample project with Maven: mvn clean install
.
Test the sample code on the command line. Refer to the How Tos for details about running samples. Additional details also reside in the Javadoc.
Tip
Command line execution is not mandatory. You can import the samples Maven project into your preferred IDE (e.g. IntelliJ/Eclipse) and run the samples from there.
For security reasons you may wish to confirm the installer’s authenticity. To do so,
After installing the package, navigate to dc-services-sdk-1.0.0.jar.sha1.
Calculate the hash with any 3rd party utility.
Find and open dc-services-sdk-1.0.0.jar.sha1. Note: if you’re using Maven, look in the .m2 directory.
Verify the hash you generated matches the value in the .sha1 file.
5dbcfcef8c5480263331e528e5a800891453e1bf
Refer to the API docs for error and exception details.
For logging, use the slf4j API with a log4j2-slf4j binding.
Logging configurations are provided in src/main/resources/log4j2.properties.
Specify alternate bindings, if required, in pom.xml.
log4j2.properties file
name=PropertiesConfig appenders = console # A sample console appender configuration which clients can change as needed. rootLogger.level = WARN rootLogger.appenderRefs = stdout rootLogger.appenderRef.stdout.ref = STDOUT appender.console.type = Console appender.console.name = STDOUT appender.console.layout.type = PatternLayout appender.console.layout.pattern = [%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n loggers = dcservicessdk,validator,apache # Change the logging levels as desired. INFO is recommended. logger.dcservicessdk.name = com.adobe.platform.operation logger.dcservicessdk.level = INFO logger.dcservicessdk.additivity = false logger.dcservicessdk.appenderRef.console.ref = STDOUT logger.validator.name=org.hibernate logger.validator.level=WARN logger.apache.name=org.apache logger.apache.level=WARN
The sample files reference input and output files located in the sample project’s /resources/ directory. You can of course modify the files and paths or use your own files.
While the samples use Maven, you can use your own tools and process.
To build a custom project:
Access the dc-services-sdk.jar in the central Maven repository.
Use your preferred dependency management tool (Ivy, Gradle, Maven), to include the SDK .jar dependency.
Open the dc-services-sdk-credentials.json downloaded when you created your crediential.
Add the Authentication details as described above.
Jumpstart your development by bookmarking or downloading the following key resources:
This document
Input/output test files reside in the their respective sample directories
The samples project requires the following:
.NET Core: version 2.1 or above
A build Tool: Either Visual Studio or .NET Core CLI.
Once you complete the Getting credentials workflow, you will receive a zip file with content whose structure varies based on whether you opted to download personalized code samples. The zip file structures are as follows:
Personalized Download: A PDFServicesSdk-NetSamples.zip contains a private.key file and an Adobe-DC.Services.SDK.NET.Samples directory. Each sample directory contains the sample code as well as a preconfigured dc-services-sdk-credentials.json file.
Non Personalized Download: A PDFServicesSdk-Credentials.zip contains the private.key file and unconfigured dc-services-sdk-credentials.json file.
After downloading the zip, you can either run the samples in the zip directly, or you can replace the dc-services-sdk-credentials.json and private.key files in the sample code with those in the zip.
Example dc-services-sdk-credentials.json file
{
"client_credentials": {
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>"
},
"service_account_credentials": {
"organization_id": "<YOUR_ORGANIZATION_ID>",
"account_id": "<YOUR_TECHNICAL_ACCOUNT_ID>",
"private_key_file": "<PRIVATE_KEY_FILE_PATH>"
}
}
Running any sample or custom code requires the following:
Download and install the .NET SDK.
Note
The Adobe.DocumentCloud.Services Nuget package automatically downloads when you build the sample project.
The quickest way to get up and running is to download the personalized code samples during the Getting Credentials workflow. These samples provide everything from ready-to-run sample code, an embedded credential json file, and pre-configured connections to dependencies.
Extract the downloaded PDFServicesSdk-NetSamples.zip.
From the samples directory, build the sample project: dotnet build
.
Test the sample code on the command line. Refer to the How Tos for details about running samples. Additional details also reside in the .NET API docs.
If you did not choose Personalized Code Sample Download during the credential setup process:
Clone or download the samples project.
Find and replace all occurrences of dc-services-sdk-credentials.json
and private.key
files with the ones present in your PDFServicesSDK-Credentials.zip file.
From the samples directory, build the sample project: dotnet build
.
Test the sample code on the command line. Refer to the How Tos for details about running samples. Additional details also reside in the .NET API docs.
For security reasons you may wish to confirm the installer’s authenticity. To do so,
After installing the Nuget package, navigate to the .nuget directory.
Find and open adobe.documentcloud.services.1.0.0.nupkg.sha512.
Verify the hash in the downloaded file matches the value published here.
sKUFj/Q6yHtpYxhDMq5aQVYuCb7j7N5SGSogHtW3QvlvOZKhlwgw00I28MYFelFu9wYfhxizLuldTg24HSYukw==
Refer to the API docs for error and exception details.
The .NET SDK uses LibLog as a bridge between different logging frameworks. Log4net is used as a logging provider in the sample projects and the logging configurations are provided in log4net.config. Add the configuration for your preferred provider and set up the necessary appender as required to enable logging.
log4net.config file
<log4net> <root> <level value="INFO" /> <appender-ref ref="console" /> </root> <appender name="console" type="log4net.Appender.ConsoleAppender"> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%date %level %logger - %message%newline" /> </layout> </appender> </log4net>
Refer to each sample directory for the requisite input/output files.
While building the sample project automatically downloads the Nuget package, you can do it manually if you wish to use your own tools and process.
Go to https://www.nuget.org/packages/Adobe.DocumentCloud.Services/1.0.0
Download the latest package.
Jumpstart your development by bookmarking or downloading the following key resources:
This document
Once you complete the Getting credentials workflow, you will receive a zip file with content whose structure varies based on whether you opted to download personalized code samples. The zip file structures are as follows:
Personalized Download: A PDFServicesSdk-Node.jsSamples.zip contains a private.key file and an adobe-dc-services-sdk-node-samples directory. Each sample directory contains the sample code as well as a preconfigured dc-services-sdk-credentials.json file.
Non Personalized Download: A PDFServicesSdk-Credentials.zip contains the private.key file and unconfigured dc-services-sdk-credentials.json file.
After downloading the zip, you can either run the samples in the zip directly, or you can replace the dc-services-sdk-credentials.json and private.key files in the sample code with those in the zip.
Example dc-services-sdk-credentials.json file
{
"client_credentials": {
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>"
},
"service_account_credentials": {
"organization_id": "<YOUR_ORGANIZATION_ID>",
"account_id": "<YOUR_TECHNICAL_ACCOUNT_ID>",
"private_key_file": "<PRIVATE_KEY_FILE_PATH>"
}
}
Running any sample or custom code requires the following steps:
Install Node.js 10.0 or higher.
Note
The @adobe/dc-services-node-sdk npm package automatically downloads when you build the sample project.
npm install --save @adobe/dc-services-node-sdk
Extract the downloaded PDFServicesSdk-Node.jsSamples.zip.
From the samples root directory, run npm install
.
If you did not choose Personalized Code Sample Download during the credential setup process:
Download the sample project.
Find and replace all occurrences of dc-services-sdk-credentials.json
and private.key
files with the ones present in your PDFServicesSDK-Credentials.zip file.
From the samples root directory, run npm install
.
Test the sample code on the command line. Refer to the How Tos for details about running samples. Additional details also reside in the node.js API docs.
For security reasons you may wish to confirm the installer’s authenticity. To do so,
After installing the package, find and open package.json.
Find the “_integrity” key.
Verify the hash in the downloaded file matches the value published here.
sha512-9s/DNCiRrIBGRUyR2/daICFjgJmGw/faZynEUKmjJf3DddECNtqevLU26i/1xN9fX4KVKH4Tlh/b8XuhBOdwrg==
Refer to the API docs for error and exception details.
The SDK uses the use the log4js API for logging. During execution, the SDK searches for config/dc-sdk-log4js-config.json in the working directory and reads the logging properties from there. If you do not provide a configuration file, the default logging logs INFO to the console. Customize the logging settings as needed.
log4j2.properties file
{ "appenders": { "consoleAppender": { "_comment": "A sample console appender configuration. Customize the logging implementation as needed.", "type": "console", "layout": { "type": "pattern", "pattern": "%d:[%p]: %m" } } }, "categories": { "default": { "appenders": [ "consoleAppender" ], "_comment": "INFO is the minimum recommended log level for the DC SDK.", "level": "info" } } }
Refer to each sample project’s resource directory for the requisite input/output files.
While building the sample project automatically downloads the Node package, you can do it manually if you wish to use your own tools and process.
Go to https://www.npmjs.com/package/@adobe/dc-services-node-sdk
Download the latest package.