Cos’è una firma elettronica?
Una firma elettronica o firma elettronica si riferisce a dati in formato elettronico che sono logicamente associati ad altri dati in formato elettronico e che vengono utilizzati dal firmatario per firmare. Questo tipo di firma ha lo stesso valore legale di una firma autografa, purché rispetti i requisiti del regolamento specifico. Le firme elettroniche possono essere sotto forma di testo digitale, immagini, codici a barre, codici QR, ecc.
Le firme elettroniche sono un concetto legale distinto dalle firme digitali, un meccanismo crittografico spesso utilizzato per implementare le firme elettroniche. Mentre una firma elettronica può essere semplice come un nome inserito in un documento elettronico, le firme digitali sono sempre più utilizzate nel commercio elettronico e negli archivi normativi per implementare le firme elettroniche in modo crittograficamente protetto.
API GroupDocs.Signature Cloud?
GroupDocs.Signature Cloud è un’API REST per creare, verificare e cercare diversi tipi di oggetti firma nei documenti nel cloud. Esistono cinque tipi principali di firme supportate con cui è possibile operare:
- Firma del testo
- Firma del codice a barre
- Firma codice QR
- Firma digitale
- Firma dell’immagine
- Timbro Firma
Come lavorare con il documento con codice a barre utilizzando l’API di firma elettronica?
Questa API ha lo scopo di aggiungere firme elettroniche ai documenti, in base ai parametri passati come una matrice di opzioni di firma. Il documento sottoposto a rendering può essere scaricato utilizzando gli URL o i percorsi di output.
Ecco i passaggi per lavorare con la firma del documento:
- Carica il file in un archivio.
- Crea una firma.
- Verifica una firma.
- Cerca una firma.
- Scarica il file Html.
1. Carica il file in un archivio
Il codice seguente illustra come caricare i file in un archivio.
### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/storage/file/signaturedocs%2Fone-page.docx?storageName=MyStorage"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
Ora il nostro file “one-page.docx” è disponibile nella cartella “signaturedocs” in archivio.
2. Creazione di una firma con codice a barre
GroupDocs.Signature Cloud REST API supporta la firma di un documento con codice a barre. Fornisce metodi per creare la firma del codice a barre nelle pagine del documento con diverse opzioni di tipo di codice a barre, posizione, allineamento, carattere, margini e aspetti utilizzando i dati Oggetti opzione firma nel corpo della richiesta.
Il codice seguente mostra come creare la firma del codice a barre.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/create"
-H "accept: application/json" -H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": { \"FilePath\": \"one-page.docx\", \"StorageName\": \"MyStorage\", \"VersionId\": \"\",
\"Password\": \"\" }, \"SaveOptions\": { \"OverwriteExisting\": true, \"OutputFilePath\": \"result-one-page.docx\", \"SaveFormat\": \"docx\" },
\"SignOptions\": [ { \"DocumentType\": \"WordProcessing\", \"SignatureType\": \"Barcode\", \"Page\": 1, \"AllPages\": false,
\"PagesSetup\": { \"FirstPage\": false, \"LastPage\": true, \"OddPages\": false, \"EvenPages\": true, \"PageNumbers\": [1] },
\"Text\": \"John Smith\", \"BarcodeType\": \"Code128\", \"Left\": 2, \"Top\": 2, \"Width\": 200, \"Height\": 100, \"Stretch\": \"None\",
\"RotationAngle\": 45, \"HorizontalAlignment\": \"Left\", \"VerticalAlignment\": \"Center\", \"LocationMeasureType\": \"Pixels\", \"SizeMeasureType\": \"Pixels\",
\"Margin\": { \"All\": 5, \"Left\": 5, \"Top\": 5, \"Right\": 5, \"Bottom\": 5 }, \"MarginMeasureType\": \"Pixels\",
\"Font\": { \"FontFamily\": \"Times New Roman\", \"FontSize\": 14.0, \"Bold\": false, \"Italic\": false, \"Underline\": false },
\"ForeColor\": { \"Web\": \"DarkOrange\" }, \"BorderColor\": { \"Web\": \"DarkOrange\", \"Alpha\": \"20\", },
\"BackgroundBrush\": { \"Color\": {\"Web\": \"DarkBlue\"}, \"BrushType\": \"SolidBrush\" },
\"BorderVisiblity\": true, \"BorderDashStyle\": \"Dash\", \"BorderTransparency\": 0.55, \"BorderWeight\": 12.0, \"BackgroundTransparency\": 0.8,
\"TextHorizontalAlignment\": \"Left\", \"TextVerticalAlignment\": \"Top\", \"Opacity\": 0.5, \"CodeTextAlignment\": \"Below\",
\"InnerMargins\": { \"All\": 5, \"Left\": 5, \"Top\": 5, \"Right\": 5, \"Bottom\": 5 },} ]}"
3. Verifica una firma
GroupDocs.Signature Cloud REST API fornisce metodi per verificare la firma del codice a barre nelle pagine dei documenti con diverse opzioni per numero di pagina, testo e criteri di ricerca utilizzando i dati Oggetti opzioni di verifica nel corpo della richiesta.
Il codice seguente mostra come verificare la firma del codice a barre.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/verify"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{\"FileInfo\": {\"FilePath\": \"signed/Signed_BarCode.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\",},\"VerifyOptions\": [{\"DocumentType\": \"Pdf\",
\"SignatureType\": \"Text\",\"Page\": 1,\"Text\": \"John\",\"MatchType\": \"Contains\"}] }}} ]}"
4. Cerca una firma
GroupDocs.Signature Cloud API fornisce un metodo per cercare la firma del codice a barre nelle pagine del documento con diverse opzioni tipo di codice a barre, nome, testo, tipo di corrispondenza e altre funzioni di ricerca utilizzando i dati Search Options Object nel corpo della richiesta.
Il codice seguente mostra come eseguire la ricerca della firma del codice a barre .
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/search"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": {\"FilePath\": \"signaturedocs/one-page.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\" }, \"SearchOptions\": [ {\"DocumentType\": \"Pdf\",\"SignatureType\": \"Barcode\",
\"Page\": 1,\"Text\": \"123\",\"BarcodeType\": \"Code128\",\"MatchType\": \"Contains\"}] }"
5. Download file
Il codice seguente mostra come scaricare un file specifico.
### Download document from default storage
curl -X GET "https://api.groupdocs.cloud/v2.0/signature/storage/file/one-page.docx?storageName=MyStorage"
-H "accept: multipart/form-data"
-H "authorization: Bearer [Access Token]"
Questo è tutto.
Inizia una prova gratuita oggi
Inizia oggi stesso una prova gratuita: tutto ciò di cui hai bisogno è iscriverti al servizio GroupDocs Cloud. Dopo esserti registrato, sei pronto per provare le potenti funzionalità di elaborazione dei file offerte da GroupDocs Cloud.