Chicos, el tedioso trabajo de los viejos tiempos de firmar un documento se ha ido, cuando solía imprimir, firmar, escanear y publicar los documentos. Ahora, en esta era digital, las opciones de firma de documentos en línea simplifican la vida. Y GroupDocs.Signature Cloud REST API es una API REST de firma electrónica probada y confiable para agregar el poder de las firmas electrónicas en sus aplicaciones sin instalar ningún software de terceros. Le ayuda a proteger electrónicamente sus documentos mediante la aplicación de texto, sello, código QR, código de barras, imagen y firmas digitales. Se lanza la nueva versión de GroupDocs.Signature Cloud 19.5.
Consulte las notas de la versión detalladas de esta versión para tener una idea de todas las nuevas características/mejoras realizadas en esta versión.
Qué hay de nuevo
Versión de API: se introdujo la versión de API V2
Autenticación: autenticación JWT (token web JSON)
API de firma: métodos API simplificados para crear, verificar y buscar firmas, al igual que obtener información adicional de documentos
API de archivo: métodos introducidos para cargar, descargar, copiar, mover y eliminar archivos: documentos de entrada y resultados de procesamiento, en el almacenamiento en la nube
API de carpetas: métodos introducidos para crear, copiar, mover y eliminar carpetas en el almacenamiento en la nube
API de almacenamiento: métodos introducidos para obtener información de almacenamiento e información de archivos
Cómo funciona
El cambio principal en esta versión es la introducción de la versión API V2, es una versión API completamente nueva. Es una API más simplificada con menos métodos y opciones. Además, tiene una arquitectura interna más optimizada y refinada. En esta versión, la API incluye métodos para trabajar con almacenamiento en la nube. Por lo tanto, puede realizar operaciones de almacenamiento utilizando la API REST de GroupDocs.Signature Cloud en lugar de utilizar una API independiente.
Aquí le mostraremos cómo funciona la versión API V2 de GroupDocs.Signature Cloud y es diferente a la V1. Agregaremos la firma de código de barras en un documento de Word usando V1 y V2 siguiendo estos pasos:
- Recuperar token de acceso
- Subir documento de origen al almacenamiento
- Agregar firma de código de barras al documento de origen
Puede notar a partir de los siguientes ejemplos de cURL que hemos utilizado la autenticación JWT en el ejemplo V2. Tenga en cuenta que los métodos de autenticación de solicitud de firma de URL y OAuth 2.0 de la versión API V1 ya no son compatibles con V2. Ahora, la versión V2 de la API es compatible con la autenticación JWT (JSON Web Token).
En el nuevo método de lanzamiento, usamos el método de archivo de la API V2 para cargar archivos en el almacenamiento en lugar del método GroupDocs.Storage Cloud. Y la última diferencia con respecto a los siguientes ejemplos, pero no menos importante, en V2 se utiliza una creación de API única para todos los tipos de firma admitidos al pasar los detalles de la firma como parámetro. Sin embargo, en V1 solíamos llamar a diferentes API para cada tipo de firma.
Ejemplo 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"}"
Ejemplo 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 },} ]}"
Suministre realimentación
No dude en enviarnos un comentario a continuación compartiendo sus opiniones sobre la nueva versión de GroupDocs.Signature Cloud 19.5. O visite nuestro Foro de soporte y háganos saber si tiene alguna sugerencia o si necesita alguna característica o mejora en particular que espera que tenga nuestra API.
Y si aún no ha tenido la oportunidad de probar nuestra API REST, simplemente inicie una prueba gratuita hoy. Todo lo que necesitas es registrarte con groupdocs.cloud. Una vez que se haya registrado, estará listo para probar las potentes funciones de procesamiento de archivos que ofrece groupdocs.cloud.