Ragazzi, il noioso lavoro dei vecchi tempi di firmare un documento è finito, quando eravate soliti stampare, firmare, scansionare e spedire i documenti. Ora, in questa era digitale, le opzioni di firma dei documenti online hanno reso la vita più facile. E GroupDocs.Signature Cloud REST API è un’API REST di firma elettronica testata e affidabile per aggiungere la potenza delle firme elettroniche nelle tue applicazioni senza installare alcun software di terze parti. Ti aiuta a proteggere elettronicamente i tuoi documenti applicando testo, timbro, codice QR, codice a barre, immagine e firme digitali. Viene rilasciata la nuova versione di GroupDocs.Signature Cloud 19.5.
Si prega di controllare le note di rilascio dettagliate di questa versione per avere un’idea di tutte le nuove funzionalità/miglioramenti apportati in questa versione.
Cosa c’è di nuovo
Versione API - Introdotta la versione API V2
Autenticazione: autenticazione JWT (JSON Web Token).
Signature API - Metodi API semplificati per creare, verificare e cercare firme, come ottenere ulteriori informazioni sui documenti
File API – Introdotti metodi per caricare, scaricare, copiare, spostare, eliminare file: documenti di input e risultati di rendering, nel cloud storage
API Folder - Introdotti metodi per creare, copiare, spostare, eliminare cartelle nel cloud storage
API di archiviazione: sono stati introdotti metodi per ottenere informazioni sull’archiviazione e informazioni sui file
Come funziona
Il principale cambiamento in questa versione è l’introduzione della versione API V2, è tutta una nuova versione API. È un’API più semplificata con meno metodi e opzioni. Inoltre, ha un’architettura interna più ottimizzata e raffinata. In questa versione, l’API include metodi per lavorare con il cloud storage. Quindi puoi eseguire operazioni di archiviazione utilizzando l’API REST di GroupDocs.Signature Cloud invece di utilizzare un’API separata.
Qui ti mostreremo come funziona la versione dell’API GroupDocs.Signature Cloud V2 ed è diversa dalla V1. Aggiungeremo la firma del codice a barre in un documento Word utilizzando V1 e V2 seguendo questi passaggi:
- Recupera token di accesso
- Carica il documento di origine in Archiviazione
- Aggiungi la firma del codice a barre al documento di origine
Puoi notare dai seguenti esempi di cURL che abbiamo utilizzato l’autenticazione JWT nell’esempio V2. Tieni presente che i metodi di autenticazione della richiesta di firma dell’URL e OAuth 2.0 della versione API V1 non sono più supportati nella versione V2. Ora, la versione API V2 supporta l’autenticazione JWT (JSON Web Token).
Nel nuovo metodo di rilascio abbiamo utilizzato il metodo File dell’API V2 per caricare il file nell’archivio anziché il metodo GroupDocs.Storage Cloud. E l’ultima differenza dai seguenti esempi, ma non meno importante, in V2 viene utilizzata una singola creazione API per tutti i tipi di firma supportati passando i dettagli della firma come parametro. Tuttavia, in V1 chiamavamo API diverse per ogni tipo di firma.
Esempio V1.1
### Retrieve access token
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl "https://api.groupdocs.cloud/oauth2/token"
-X POST
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
-H "Content-Type: application/x-www-form-urlencoded"
-H "Accept: application/json"
### Upload file to Aspose Cloud Storage
curl "https://api.aspose.cloud/v1.1/storage/file?path=one-page.docx"
-X PUT
-T C:/Temp/one-page.docx
-H "Content-Type: multipart/form-data"
-H "Accept: application/json"
-H "Authorization: Bearer [ACCESS_TOKEN]"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v1/signature/one-page.docx/barcode"
-X POST
-H "accept: application/json"
-H "Content-Type: application/json"
-H "authorization: Bearer [ACCESS_TOKEN]"
-d "{"BarcodeTypeName": "Code128","BorderVisiblity" : true,"BorderDashStyle" : "DashDotDot","BorderWeight" : 1,"Opacity" : 0.5,"Margin": {"All": 0,"Left": 0,"Top": 0,"Right": 0,"Bottom": 0},"SheetNumber": 1,"RowNumber": 11,"ColumnNumber": 22,"BorderVisiblity": true,"BorderDashStyle": 5,"BorderTransparency": 0.0,"BorderWeight": 1.0,"BackgroundTransparency": 0.1,"SignatureImplementation": "TextStamp","Text": "John Smith","Width": 100,"Height": 100,"LocationMeasureType": "Pixels","SizeMeasureType": "Pixels","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Center","MarginMeasureType": "Pixels","SignAllPages": false,"Font": {"FontFamily": "Times New Roman","FontSize": 14.0,"Bold": false,"Italic": false,"Underline": false},"ForeColor": {"Web": "Black"},"BorderColor": {"Web": "Black"},"BackgroundColor": {"Web": "OrangeRed"},"OptionsType": "WordsSignBarcodeOptionsData"}"
Esempio V2.0
### Retrieve access token JWT(JSON Web Token)
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl -v "https://api.groupdocs.cloud/connect/token"
-X POST
-H "Content-Type: application/x-www-form-urlencoded"
-D "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
### Upload file into the storage
curl --request POST "https://api.groupdocs.cloud/v2/signature/storage/file/one-page.docx"
--header "authorization: Bearer [ACCESS_TOKEN]"
--data-binary @"c:\temp\one-page.docx"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v2.0/signature/create"
-X POST
-H "accept: application/json"
-H "authorization: Bearer [ACCESS_TOKEN(JWT)]"
-H "Content-Type: application/json"
-d "{"FileInfo": { "FilePath": "one-page.docx", "StorageName": "", "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 },} ]}"
Fornire un feedback
Sentiti libero di lasciarci un commento qui sotto condividendo i tuoi pensieri sulla nuova versione di GroupDocs.Signature Cloud 19.5. Oppure visita il nostro Forum di supporto e facci sapere se hai suggerimenti o se hai bisogno di particolari funzionalità/miglioramenti che ti aspetti dalla nostra API.
E se non hai ancora avuto la possibilità di provare la nostra API REST, avvia semplicemente una prova gratuita oggi stesso. Tutto ciò di cui hai bisogno è iscriverti a groupdocs.cloud. Dopo esserti registrato, sei pronto per provare le potenti funzionalità di elaborazione dei file offerte da groupdocs.cloud.