Document eSignature Java Cloud REST API

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial

GroupDocs.Signature Cloud SDK for Java helps you build cloud Document eSigning Java Apps that work without installing any 3rd party software. It is a wrapper around GroupDocs.Signature Cloud REST APIs.

Cloud Document eSing SDK Features

• Sign cloud documents with the following type of signatures:
  • Text Signature
    • A string of your desired text added to the cloud document.
    • Ability to customize text signature styling, formatting, & alignment.
  • Image Signature
    • Create an image with your desired graphics such as company logo to be applied as an eSignature
    • Customize image colors, it’s location, content, and other advanced effects.
  • Digital Signature
    • Create digital signature based on PFX certificate.
    • Ability to cloud digital signature visible or hidden on the cloud document page.
  • Stamp Signature
    • A round seal electronic signature whose visual appearance can be customized.
    • Can have multiple stamp lines to hold user-defined text.
    • Ability to configure line color, thickness, font weight, etc.
  • Barcode Signature
    • Create and apply various types of machine-readable barcodes as e-signatures to the cloud files.
    • Option to choose barcode from a wide rangle of barcode symbologies.
  • QR-Code Signature
    • Create and apply 2D QR-Code barcodes of various types to the cloud hosted documents.
• Apply multiple types of electronic signatures (eSignatures) to the same cloud document.
• Ability to fetch lists of supported barcodes, QR-Codes, supported file formats as well as get other cloud document information.

Supported File Formats for Cloud Text, Stamp, Image Signature

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX
OpenOffice Calc®: ODS
Microsoft PowerPoint®: POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTX
OpenOffice Impress®: ODP
Images: JPG, PNG, BMP, GIF, TIFF
CorelDRAW®: CDR
Fixed Layout: PDF

Supported File Formats for Cloud Digital Signature

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX
OpenOffice Writer®: ODT
Microsoft Excel®: XLS, XLSM, XLSX, XLT, XLTM, XLTX
Microsoft PowerPoint®: PPTM, PPTX
Fixed Layout: PDF

Supported File Formats for Cloud BarCode Signature

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX
OpenOffice Calc®: ODS
Microsoft PowerPoint®: POT, POTM, PPSX, PPTX
OpenOffice Impress®: ODP
Images: JPG, PNG, BMP, GIF, TIFF
CorelDRAW®: CDR
Fixed Layout: PDF

Supported File Formats for Cloud QR-Code Signature

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF
OpenOffice Writer®: OTT
Microsoft Excel®: XLS, XLSM, XLSX, XLT, XLTM, XLTX
Images: JPG, PNG, BMP, GIF, TIFF
CorelDRAW®: CDR
Fixed Layout: PDF

Please visit Supported File Formats for the complete list.

Supported Document eSigning File Formats

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF, TXT
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLSB, XLSM, XLSX, CSV, TSV
OpenOffice Calc®: ODS, OTS
Microsoft PowerPoint®: POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX
OpenOffice Impress®: ODP, OTP
Images: BMP, CGM, DJVU, DNG, GIF, ICO, JP2, JPF, JPX, J2K, J2C, JPM, JPG, JPEG, ODG, PCL, PNG, TIF, TIFF
CorelDRAW®: CDR, CMX
Medical Imaging: DCM
Photoshop®: PSD
Vector Images: SVG
Postscript: PS, EPS
Fixed Layout: PDF
Meta Files: EMF, WMF

Please visit Supported Document Formats for a more comprehensive list.

Requirements

Building the API client library requires:

1. Java 1.7+
2. Maven

Prerequisites

To use GroupDocs.Signature Cloud SDK for Java you need to register an account with GroupDocs Cloud and lookup/create Client ID and Client Secret at Cloud Dashboard. There is free quota available. For more details, see GroupDocs Cloud Pricing.

Install GroupDocs.Signature-Cloud from Maven

Add GroupDocs Cloud repository to your application pom.xml

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

Install from source

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project’s POM:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature-cloud</artifactId>
    <version>21.11</version>
</dependency>

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

• target/groupdocs-signature-cloud-21.11.jar
• target/lib/*.jar

Get Started

Please follow the Quick Start instructions.

eSign Cloud Document with Image Signature via Java Cloud SDK

// For complete examples and data files, please go to https://github.com/groupdocs-signature-cloud/groupdocs-signature-cloud-java-samples
String MyClientSecret = ""; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
String MyClientId = ""; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyClientId, MyClientSecret);
SignApi apiInstance = new SignApi(configuration);

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Signaturedocs\\one-page.docx");
fileInfo.setPassword(null);
fileInfo.setVersionId(null);
fileInfo.setStorageName(Constants.MYStorage);

InfoSettings infoSettings = new InfoSettings();
infoSettings.setFileInfo(fileInfo);

SignImageOptions options = new SignImageOptions();
options.setSignatureType(SignatureTypeEnum.IMAGE);

// set signature properties
options.setImageFilePath("Signaturedocs\\signature.jpg");

// set signature position on a page
options.setLeft(100);
options.setTop(100);
options.setWidth(200);
options.setHeight(100);
options.setLocationMeasureType(LocationMeasureTypeEnum.PIXELS);
options.setSizeMeasureType(SizeMeasureTypeEnum.PIXELS);
options.setRotationAngle(0);
options.setHorizontalAlignment(HorizontalAlignmentEnum.NONE);
options.setVerticalAlignment(VerticalAlignmentEnum.NONE);

Padding padding = new Padding();
padding.setAll(5);
options.setMargin(padding);
options.setMarginMeasureType(MarginMeasureTypeEnum.PIXELS);

*set pages for signing (each of these page settings could be used singly)
options.setPage(1);
options.setAllPages(true);

PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setEvenPages(false);
pagesSetup.setFirstPage(true);
pagesSetup.setLastPage(false);
pagesSetup.setOddPages(false);
pagesSetup.addPageNumbersItem(1);
options.setPagesSetup(pagesSetup);

SaveOptions saveOptions = new SaveOptions();
saveOptions.setOutputFilePath("Signaturedocs\\signedImage_one-page.docx");

SignSettings signSettings = new SignSettings();
signSettings.setFileInfo(fileInfo);
signSettings.addOptionsItem(options);
signSettings.setSaveOptions(saveOptions);

CreateSignaturesRequest request = new CreateSignaturesRequest(signSettings);

SignResult response = apiInstance.createSignatures(request);

Authorization & Authentication

Authentication schemes defined for the API is as follows:

JWT

• Type: OAuth 2.0
• Flow: application
• Authorization URL: https://api.groupdocs.cloud/connect/token
• Token Lifetime: 1 day (Default)

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial