After successful creation of the signing request, next step is to open the document for signing. Document is opened by calling the Open document service. To open document use attribute url from Signature request service response
{
"message": "msg.signature.request.id.created",
"result": "1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8",
"url": "https://apidev.okdokument.com/openDocument/1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8",
"documentId": "y7Ki_u1mrUwijfb-o_S1JiphSsoXya8iypH380F"
}Service displays the PDF document in OKdokument graphic interface.
After the user signs (or cancels) the document there are several possibilities what can happened according to Signature request service parameters configuration:
- User is redirected to OKdokument default “Thank you page”
- Backend to backed communication is initialised (see chapter 2.4 Information about signing completion)
- User is redirected to Portal result url (see chapter 2.5 Result URL)
Service specifications #
| URL | https://apidev.okdokument.com/openDocument/{signatureRequestId} |
| Method | GET |
| URL parameter signatureRequestId | unique identifier used in /JSON/signatureRequest method |
Example with signature request id:
| https://apidev.okdokument.com/openDocument/1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8 |
HTTP- Click to view HTTP code snippet
GET /openDocument/1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8 HTTP/1.1
Host: localhost:8080