Signing Url using GroupDocs API


#1

Can somebody please help me with the list of GroupDocs API calls that are needs to create an envelope, put a document in it, assign a signer, place signing block and generate a signing Url which can be sent to somebody for signing?


#2

Hi @sudiptamodak Thank you for your interest in GroupDocs. Please check our documentation here and you will find code examples for how to do all you need.


#3

Thanks for the reply. The example in the link given by you mentions creation of the envelope which I have already been able to accomplish. I need a way to generate a signing Url that can be rendered in any browser and the recipient can sign it.

We are evaluating many signing providers (DocuSign, AdobeSign, SignNow, etc) for the development of a signing solution in CDK Global (https://www.cdkglobal.com/) and one of our prime requirements is to have the ability to generate a signingUrl which can then be rendered in any browser (on multiple devices) to allow us to take signatures from customers.

Is is possible to have a support call with you to be able to present our problems in a better way?


#4

Hi @sudiptamodak To render the envelop you will need such URL https://apps.groupdocs.com/signature2/signembed/{envelop id}/{recipient id}

Where:
envelop id you will get in response from the CreateSignatureEnvelope method call
recipient id to get this data you will need to add recipient as described here and then get recipient data as described here

Best regards.


#5

Thanks for the reply. I am trying to follow the example in http://groupdocs-java-samples.herokuapp.com/assets/docs/Sample21.html

While uploading a document from my local system, I get ‘Nullpointer’ exception. Following is the code:

File signDoc = new File("/Users/modaks/Documents/uSign/SignNow/sample_blank_pdf.pdf");
Http.MultipartFormData.FilePart file = new Http.MultipartFormData.FilePart(“key”, signDoc.getName(), “PDF”, signDoc);
StorageApi storageApi = new StorageApi();
storageApi.setBasePath(“https://api.groupdocs.com/v2.0”);
FileInputStream is = new FileInputStream(file.getFile());
UploadResponse uploadResponse = storageApi.Upload(“945fc5dcf4632053”, signDoc.getName(), “uploaded”, “”, 1, new FileStream(is));

I also tried to Upload a file using a url

StorageApi storageApi = new StorageApi();
storageApi.setBasePath(“https://api.groupdocs.com/v2.0”);
UploadResponse uploadResponse = storageApi.UploadWeb(“945fc5dcf4632053”, “http://phnompenh.gov.kh/wp-content/uploads/2015/05/blank.pdf”);

Can you help?


#6

Hello @sudiptamodak,

From your code example , I see that you are missed the RequestSigner initialisation :

ApiInvoker.getInstance().setRequestSigner( new GroupDocsRequestSigner(“your private _key”));

This initialization is very important, so please add it and test your code again.

Best regards,
Evgen Efimov


#7

Thanks for the reply.

I am now able to generate the signing Url using API in response to the following API request:

PUT https://api.groupdocs.com/v2.0/signature/945fc5dcf4632053/envelopes/5d1a6ece528cf7d13ded3520d80a98e7/send?signature=wQ4n1Y3JrMv0d2eak2RWYNLPMW8

Response:
{
“result”: {
“recipients”: [
{
“id”: “df775cfbe609083c96697ddfae8e10fe”,
“firstName”: “Sudipta”,
“lastName”: “Modak”,
“email”: "sudipta.modak@cdk.com",
“userGuid”: “565ed35507972b5f”,
“order”: 0,
“roleId”: 2,
“status”: 1,
“statusMessage”: null,
“statusDateTime”: “2017-10-09T18:13:58.1710401ZZ”,
“delegatedRecipientId”: null,
“signatureFingerprint”: null,
“signatureHost”: null,
“signatureLocation”: null,
“signatureBrowser”: null,
“embedUrl”: “https://apps.groupdocs.com/signature/signembed/5d1a6ece528cf7d13ded3520d80a98e7/df775cfbe609083c96697ddfae8e10fe”,
“comment”: null
}
]
},
“status”: “Ok”,
“error_message”: null,
“composedOn”: 1507572837625
}

The embedUrl that I get throws a 404 when I paste it to browser.

But the Url I get in the mail (https://apps.groupdocs.com/signature2/signembed/5d1a6ece528cf7d13ded3520d80a98e7/df775cfbe609083c96697ddfae8e10fe) works. I noticed that the Url in mail has a ‘signature2’ appended to baseUrl whereas the ‘enbedUrl’ that comes from API response has a ‘signature’ appended. So, the Urls are different. Can you confirm if this is a possible error?


#8

Hello @sudiptamodak,

We are described it in our documentation of the demo example (http://prntscr.com/gvh97a). As you can see that to build correct enbedUrl you should use only this configuration:

String enbedUrl = “https://apps.groupdocs.com/signature2/signembed/" + envelopeGuid + “/” + recipientGuid;

So, please use it for your tests.


#9

Thanks for the reply


#10

You are welcome.