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 response from signature Request service
| “url”: “https://apidev.okdokument.com/openDocument/1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8” |
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 |
| Response | HTTP status 302 when PDF document is uploaded and processed successfully, user is transferred to the document view HTTP status 400 when signatureRequestId is invalid |
Example with signature Request id:
| https://apidev.okdokument.com/openDocument/1d58a59e-e8f7-4d07-bb99-d3fa39cb58a8 |
Response header example with document id:
| HTTP/1.1 302 Location: https://apidev.okdokument.com/viewDocument?id= y7Ki_u1mrUwijfb-o_S1JiphSsoXya8iypH380F |