Send Document
You can send document to tablet with this request.
You need to use access token that you've got
Authentication
section in this request.
Request
Syntax:
POST /document_to_tablet HTTP/1.1
Host: ServiceURL
Authorization: Bearer token
Connection: keep-alive
Content-Type: multipart/form-data
Argument:
Parameter | Description | Mandatory |
subject | Cancel Document | Yes |
description | Description | Yes |
document | Base64 String of document | Yes |
ID | Identity number such as RUT, DNI, NIF | Yes |
tablet_id | ID of tablet that you want to send document to | Yes |
callbackURL | Callback URL of your service | No |
is_fingerprint | Set as true if you want to ask the signer's fingerprint in document. | No |
is_NID | Set as true if you want to ask the signer's identity images. | No |
is_text | Set as true if you want to ask to signer to add extra page at the end of the document. | No |
is_email | Set as true if you want to send signed document to someone you want via email. | No |
addComment | Set as true if you want to ask to signer to leave some comment to document. | No |
anchor | The specific word in your document which you want to put the signature image on. Please go to Signature Position section to see more details | No |
posX | X coordination of the bottom left corner of the signature image. Please go to Signature Position section to see more details | No |
posY | Y coordination of the bottom left corner of the signature image. Please go to Signature Position section to see more details | No |
PosX1 | X coordination of the top right corner of the signature image. Please go to Signature Position section to see more details | No |
PosY1 | Y coordination of the top right corner of the signature image. Please go to Signature Position section to see more details | No |
pageNo | The page number of document which page you want to put the signature image in. Please go to Signature Position section to see more details | No |
deleteAfterSign | Please set true if you want to delete from legale after getting back the signed document | No |
attached1 | Base64 string of attached file1 | No |
attached2 | Base64 string of attached file2 | No |
attached3 | Base64 string of attached file3 | No |
If you set callbackURL, you can get signed document with that URL. Firma legale service will send a request to your callback URL with signed document so that you can get that after signing immediately. Please see Callback section to get more information
{
"document": "JVBE...",
"subject": "test document to tablet",
"description": "test document to tablet from POSTMAN",
"ID": "11222333-4",
"tablet_id": "d-C-D4Ums...",
"is_fingerprint": true,
"is_NID": false,
"is_text": true,
"is_email": false,
"addComment": true,
"callbackURL": "https://yourhost.com/yourcallbackURL",
"anchor": "signer1",
"posX": 0,
"posY": 0,
"posX1": 400,
"posY1": 150,
"pageNo": 1,
"deleteAfterSign": false,
"attached1": "JVBE...",
"attached2": "JVBE...",
"attached3": "JVBE...",
}
Response
Success:
{
"success": true,
"GUID": "82f13f65-7829-4511-92d6-25d9351683ed",
"debug": ""
}
Error:
{
"success": false,
"data": [],
"debug": "Missing Argument"
}
Other errors are following typical Restful API rules.