readPDF($readPDFRequest)
readPDF should be called when a digital signature user needs to get information (page information, meta-data, form information, signature information) of the PDF document. It can be retrieved via a soap request using the "readPDF" method to https://api.maxsignatures.com/MdDigitalSignatureReadPDFApi.php?wsdl.
readPDFRequestType:{
accountInfo:{
//used to authenticate the user who upload the document
username:'',
//account name, for example: abc@mdemail.md
password:'',
//password
},
validateSignatures:
//boolean type. Whether get signature information
document:{
data:
//base64encoded data of the document
},
....
}
Response
....
readPDFResponseType:{
code:'',
//string type. A response code. This will be "000" if there is no error
message:'',
//string type. A description of the response code
pdfInfo{'',
//PDF information
pages:{
// an array of page information. Sorted by page index
index:
//page index (start from 1)
height:
//height of the page
width:
//width of the page
rotate:
//roated degree of the page (usually: 0, 90, 180, 270)
},
metaData:{
// an array of metadata information.
key:
//metadata key
value:
//metadata value
},
signatures:{
// an array of signature information.
name:
// name of the signature
width:
// width of the signature
height:
// height of the signature
left:
// position.left of the signature
top:
// position.top of the signature
pageIndex:
// page index of the signature (start from 1)
isSigned:
// boolean value, whether the signature box is signed. If false, means it is a unsigned signature field
signerName:
// who signed the signature
SignatureTime:
// string value, timestamp of the signature
Reason:
// reason code on the signature
isValid:
// boolean value, whether the signature is valid
},
formFields:{
// an array of form field information.
name:
// name of the field
height:
// height of the field
width:
// width of the field
tabIndex:
// tabIndex of the field (start from 1)
value:
// value of the field
left:
// position.left of the field
top:
// position.top of the field
type:
// type: "TEXTFIELD", "RADIOGROUP", "COMBO" or "CHECKBOX"
format:
// format for the textfield. Default value is "normal". For example format=="date", then the formfield will be understood as a date input
required:
// boolean value, whether the field is required
readonly:
// boolean value, whether the field is readonly
pageIndex:
// page index of the field (start from 1)
options: {
// An array of options. This parameter is available when the field type is "COMBO" or "RADIOGROUP"
default:
// boolean value: whether the option is default one
value:
// value of the option
label:
// label of the option
}
}
}
Sample Code (using NuSoap) (PHP)
The xml for the WSDL can be found here