Acrobat Sign OpenAPI SDK¶
The Acrobat Sign SDK supports integrating the Acrobat Sign RESTful web service into client applications via easy-to-consume client side objects wrapping the REST API functionality. This repository contains JSON files and instructions you can use to generate Acrobat Sign’s SDK for V6 REST APIs in various languages.
For the generation of Acrobat Sign SDK, the client machine should have the following software installed:
Java JDK: version 1.8 or above
Maven: 3.3.3 version or above
Gradle: 2.11 version or above
The Acrobat Sign clients need to follow the below steps in order to get started with it:
In order to use the SDK, you need to have an account with Acrobat Sign. Please register for a developer account here
Sign in to create an application on the Acrobat Sign web portal and obtain it’s application id and application secret.
Generate the OAuth access token by using the above application id and the application secret. The access token will need to be generated by using the OAuth APIs.
Use the generated OAuth access token for trying out the sample API code (or directly in the client application code) provided in the SDK.
Downloading and Building the SDK¶
Download the Swagger Codegen and unzip the archive to a folder of your choosing. You can also sync the git repo on your local machine. swagger-codegen-2.3.1 will be referred as the root directory
After cloning the project, you can build it from source with this command in root folder:
mvn clean package
Download the json folder from the GitHub, and copy it under root folder swagger-codegen-2.3.1
To generate SDK classes for Agreement Resource at output folder (/var/tmp/AdobeSignJavaSdk) using agreements.json, run following command in root directory :
java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \ -i json/agreements.json \ -l java \ -o /var/tmp/AdobeSignJavaSdk \ -DdateLibrary=legacy \ --http-user-agent=AdobeSign_JavaSdk_1_0 (if you're on Windows, replace the last command with `java -jar modules\swagger-codegen-cli\target\swagger-codegen-cli.jar generate -i json\agreements.json -l java -o c:\temp\AdobeSignJavaSdk -DdateLibrary=legacy --http-user-agent=AdobeSign_JavaSdk_1_0`)
Similarly, in order to generate SDK for other resources, replace agreements.json in previous command with JSON file of corresponding resource.
If you want to compile all the SDK source classes, a single command can be used in output folder(/var/tmp/AdobeSignJavaSdk) :
If you want the JAR file of the SDK, you can find it at the location:
The AdobeSignJavaSdk/src/main/java/io/swagger/client folder contains all the Acrobat Sign APIs.
Packages containing APIs are laid out as follows:
Each class represents a resource and the class methods refers to the operations that can be performed on that resource. Each such operation is called API. e.g. AgreementsAPI.java contains getAgreements method which retrieves all the agreements for the user.
Each class represents request or response class required in the API calls. The classes are not resource specific and can be found under this folders for all the resources.