Table of contents
Upload of documents
Once a Signature Request has been successfully created, the PDF documents to be signed must be uploaded via the REST API.
The files are not uploaded directly to the Resource Server that expose the APIs of Sign with IO, but to the dedicated Document Storage, based on Azure BLOB Storage.
The following is necessary for each document to be signed:
- Obtain the document_id from the Signature request. In the example shown in Creation of a Signature request the document_id was: "01ARZ3NDEKTSV4RRFFQ69G5FAV";
- Obtain an Upload URL specific for the document, from the endpoint REST dedicated GET/api/v1/sign/signature-requests/{signature_request_id}/documents/{document_id}/upload_url;
- Perform the upload to the Upload URL
- Check that the document was uploaded correctly, performing a request HTTP GET to the endpoint: /api/v1/sign/signature-requests/{signature_request_id} specifying the signature_request_id and the headers necessary for authentication.
In the DOCUMENTS object, you will find the references to the documents and the state of the upload associated with them.
How to upload to the Upload URL
To upload, you have two options:
Via the SDK of Azure Storage
Use the SDK of Azure Storage of the programming language of reference.
Via http request
Make an http request (PUT) to the Upload URL, indicating in the header the request x-ms-blob-type : BlockBlob and the binary content of the file as the body of the message.
On this page
Ongoing support
For problems or questions after integration, write to us at the address enti-firmaconio@assistenza.pagopa.it