tvpl.api

<back to all web services

SignatureRequest

Requires Authentication
The following routes are available for this service:
POST/Signature
SignatureRequest Parameters:
NameParameterData TypeRequiredDescription
FileIdbodyintNo
OriginalFileIdbodyintNo
WorkflowIdbodyintNo
StepIdbodyintNo
SubDocumentIdbodyintNo
SignatureResponse Parameters:
NameParameterData TypeRequiredDescription
CodeformintNo
MessageformstringYes
SignedFileformUploadedFilesNo
SignLogformDocumentSignLogNo
UploadedFiles Parameters:
NameParameterData TypeRequiredDescription
Idformlong?No
UploadedFileformstringYes
SubDocumentIdformint?No
StepIdformint?No
CodeformintNo
BasicUploadedFile Parameters:
NameParameterData TypeRequiredDescription
FileNameformstringYes
FilekeyformstringYes
FileUrlformstringYes
ChecksumformstringYes
ETagformstringYes
FileSizeformlongNo
DocumentSignLog Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DocumentIdformlongNo
SubDocumentIdformlong?No
StepIdformintNo
FileIdformlongNo
SignProviderformstringNo
CertSerialformstringNo
IsSuccessformboolNo
SignMessageformstringNo
SignByformlongNo
SignAtformDateTimeNo
RequestIdformGuid?No
OriginalFileIdformint?No
EffectBeginDateformDateTime?No
EffectEndDateformDateTime?No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /Signature HTTP/1.1 
Host: etc-api.vsmlab.vn 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	fileId: 0,
	originalFileId: 0,
	workflowId: 0,
	stepId: 0,
	subDocumentId: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	code: 0,
	message: String,
	signedFile: 
	{
		id: 0,
		uploadedFile: String,
		subDocumentId: 0,
		stepId: 0,
		code: 0,
		fileName: String,
		filekey: String,
		fileUrl: String,
		checksum: String,
		eTag: String,
		fileSize: 0
	},
	signLog: 
	{
		id: 0,
		documentId: 0,
		subDocumentId: 0,
		stepId: 0,
		fileId: 0,
		signProvider: String,
		certSerial: String,
		isSuccess: False,
		signMessage: String,
		signBy: 0,
		requestId: 00000000000000000000000000000000,
		originalFileId: 0,
		effectBeginDate: "0001-01-01T00:00:00.0000000+07:06",
		effectEndDate: "0001-01-01T00:00:00.0000000+07:06"
	}
}