Les gars, le travail fastidieux de signature d’un document est révolu, lorsque vous aviez l’habitude d’imprimer, de signer, de numériser et de publier les documents. Désormais, dans cette ère numérique, les options de signature de documents en ligne facilitent la vie. Et GroupDocs.Signature Cloud REST API est une API REST e-Signature testée et fiable pour ajouter la puissance des signatures électroniques dans vos applications sans installer de logiciel tiers. Il vous aide à sécuriser électroniquement vos documents en appliquant du texte, un tampon, un code QR, un code à barres, une image et des signatures numériques. La nouvelle version de GroupDocs.Signature Cloud 19.5 est publiée.
Veuillez consulter les notes de version détaillées de cette version pour avoir une idée de toutes les nouvelles fonctionnalités/améliorations apportées à cette version.
Quoi de neuf
Version API - Version API introduite V2
Authentification - Authentification JWT (jeton Web JSON)
API de signature - Méthodes d’API simplifiées pour créer, vérifier et rechercher des signatures, tout comme obtenir des informations supplémentaires sur les documents
API de fichier - Méthodes introduites pour télécharger, télécharger, copier, déplacer, supprimer des fichiers : documents d’entrée et résultats de rendu, dans le stockage en nuage
API de dossier - Méthodes introduites pour créer, copier, déplacer, supprimer des dossiers dans le stockage en nuage
API de stockage - Méthodes introduites pour obtenir des informations de stockage et des informations sur les fichiers
Comment ça fonctionne
Le changement majeur dans cette version est l’introduction de la version API V2, c’est toute la nouvelle version de l’API. C’est une API plus simplifiée avec moins de méthodes et d’options. De plus, il a une architecture interne plus optimisée et raffinée. Dans cette version, l’API inclut des méthodes pour travailler avec le stockage en nuage. Ainsi, vous pouvez effectuer des opérations de stockage à l’aide de l’API REST GroupDocs.Signature Cloud au lieu d’utiliser une API distincte.
Ici, nous allons vous montrer comment fonctionne la version de l’API GroupDocs.Signature Cloud V2 et elle est différente de la V1. Nous ajouterons la signature de code-barres dans un document Word à l’aide de V1 et V2 en suivant ces étapes :
- Récupérer le jeton d’accès
- Charger le document source dans le stockage
- Ajouter la signature du code-barres au document source
Vous pouvez remarquer à partir des exemples cURL suivants que nous avons utilisé l’authentification JWT dans l’exemple V2. Veuillez noter que OAuth 2.0 et les méthodes d’authentification de demande de signature d’URL de la version API V1 ne sont plus prises en charge dans V2. Désormais, la version de l’API V2 prend en charge l’authentification JWT (JSON Web Token).
Dans la nouvelle méthode de version, nous avons utilisé la méthode File de l’API V2 pour télécharger le fichier sur le stockage au lieu de la méthode GroupDocs.Storage Cloud. Et la dernière différence par rapport aux exemples suivants, mais non des moindres, dans la V2, une création d’API unique est utilisée pour tous les types de signature pris en charge en transmettant les détails de la signature en tant que paramètre. Cependant, dans la V1, nous avions l’habitude d’appeler différentes API pour chaque type de signature.
V1.1 Exemple
### 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"}"
Exemple 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 },} ]}"
Fournir une réponse
N’hésitez pas à nous laisser un commentaire ci-dessous pour partager vos réflexions sur la nouvelle version de GroupDocs.Signature Cloud 19.5. Ou visitez notre Forum d’assistance et faites-nous savoir si vous avez des suggestions ou si vous avez besoin de fonctionnalités/améliorations particulières que vous attendez de notre API.
Et si vous n’avez pas encore eu l’occasion d’essayer notre API REST, commencez simplement un essai gratuit dès aujourd’hui. Tout ce dont vous avez besoin est de s’inscrire avec le groupdocs.cloud. Une fois inscrit, vous êtes prêt à essayer les puissantes fonctionnalités de traitement de fichiers offertes par groupdocs.cloud.