Initiate PDF Signature

Use this API, to sign the PDF documents and send back to the path provided in the request.

Resource Informations

Name	Value
Requires authentication?	Yes
Rate limited?	No

Request

Request headers

Key	Value
Authorization	Bearer token
Content-Type	multipart/form-data

HTTP request URL for SSMS

POST https://{tenantId}.{hostname}/digitanium/v3/mpower/users/{userName}/signature

HTTP request URL for SHIFT

POST https://{hostname}/auth/realms/{tenantId}/mpower/v1/users/{userName}/signature?sigantureFile={signaturefile}&sigantureData={signaturedata}

note

API requests must be made over https. Calls made over plain http will fail.

Parameters

No parameter fields are required.

Request body

Field Name	Type	Description

• sigantureFile | File | File you wanted to sign
• sigantureData | JSON | Data required to initiate PDF sign

signatureData Detail

Field Name	Type	Description

• pageNumber | File | File you wanted to sign
• topRightXCoordinate | Integer | Right side Top Y-axis value to start signature area
• topRightYCoordinate | Integer | Right side Top Y-axis value to start signature area
• bottomLeftXCoordinate | Integer | Left side Bottom X-axis value to end signature area
• bottomLeftYCoordinate | Integer | Left side Bottom Y-axis value to end signature area
• serviceUuid | uuid | UUID of the service through which signature needs to be send.
• messageText | String | Message to be displayed while sending document.
• callbackUrl | URL | URL which you want to receive pdf signature result (should be of POST method) instanceId | String | Some string value. If not provided by default a Random ID will be assigned

Sample Request

signatureData

{
    "pageNumber": 1,
    "bottomLeftXCoordinate": 60,
    "bottomLeftYCoordinate": 60,
    "topRightXCoordinate": 30,
    "topRightYCoordinate": 30,
    "serviceUuid": "4f584fde-e64d-4e1d-ac84-8b6f300ca088",
    "instanceId": "45dadd43-ab43-4e1d-ac84-8b6f300ca088",
    "messageText": "Please sign here",
    "callbackUrl": "https://<HOST>/path"
}

sigantureFile

A PDF File

Sample

--------------------------4732c647e9338d09
Content-Disposition: form-data; name="signatureData"
Content-Type: application/json

{
"pageNumber": 1,
"bottomLeftXCoordinate": 60,
"bottomLeftYCoordinate": 10,
"topRightXCoordinate": 90,
"topRightYCoordinate": 20,
"serviceUuid": "28a5fab2-47c7-46c4-9d4e-2391a0c2c58e",
"instanceId": "c5b58568-9a6e-4948-a9f0-949811df39af",
"messageText": "Please sign here",
"callbackUrl": "https://<HOST>/path"
}
--------------------------4732c647e9338d09
Content-Disposition: form-data; name="signatureFile"; filename="sample.pdf"
Content-Type: application/pdf

<PDF binary>
--------------------------4732c647e9338d09--

Response

Field Name	Type	Description
instanceId	String	Instance ID corresponding to the signature request
processId	String	Process ID which is used to fetch the signed document

Sample Response

{
    "processId":"process-0fabbc2b-33bc-4136-8b0a-asdads33232",
    "instanceId":"instance-sdfsd322-b47e-440a-9322-dsa332df342"
}

Response Status Information

Status	Type	Description
200	OK	For successfull update
400	status	Bad request
401	status	Unauthorized