Introduction
The Adobe PDF Extract API is a cloud service that extracts text, tables, images, and structure from PDF files and returns them in easy-to-use formats such as JSON or CSV.
This guide explains how to obtain authentication details for the Adobe PDF Extract API, as well as how to install an Adobe PDF Extract API Connector.
Setup & Authentication
Overview
Cyclr Partner setup:
Usually no external setup is required by you, the Cyclr Partner, as configuration and retrieval of any credentials for this Connector are performed by your customer within their system.
As a result, the Client ID and Client Secret fields within your Cyclr Partner Console’s Adobe PDF Extract API Connector Library entry should be left blank so that they’re displayed each time the Connector is installed and provided by your customer to access their data.
If necessary, the Scopes parameter – which defaults to openid,AdobeID,DCAPI – can be changed in the Connector Library entry so a different value is used by all instances of the Connector.
Your customer’s setup:
- Have access to an Adobe Developer Console.
- Create an Adobe project within an Adobe Developer Console to obtain Client ID and Client Secret values from their Adobe Developer Console.
Remote Setup in Adobe Developer Console – performed by your customer
Anyone can sign up for their own personal Adobe Developer Console, but for enterprise teams, access requires System Administrator or Developer roles within an Adobe Admin Console.
- Within an Adobe Developer Console, Create a new project
- Select Add API.
- Select the PDF Services API.
- Save the project.
- On the left panel, under Credentials, select OAuth Server-to-Server.
- Save the Client ID and Client Secret in a secure place, as they will be needed when installing the Cyclr Connector.
Cyclr Connector Installation
When installing an Adobe PDF Extract API Connector, the following values are required:
| Property | Description |
|---|---|
| Client ID | The Client ID of the Adobe project. |
| Client Secret | The Client Secret of the Adobe project. |
| Services | Used to determine the Adobe cloud region that will process the PDF extractions; where the document is processed and stored while executing the job. |