Pessoal, o tedioso trabalho de assinar um documento acabou, quando você costumava imprimir, assinar, digitalizar e postar os documentos. Agora, nesta era digital, as opções de assinatura de documentos online tornaram a vida mais fácil. E GroupDocs.Signature Cloud REST API é testado e confiável e-Signature REST API para adicionar o poder de assinaturas eletrônicas em seus aplicativos sem instalar nenhum software de terceiros. Ele ajuda você a proteger eletronicamente seus documentos aplicando Texto, Carimbo, QR-Code, Código de Barras, Imagem e Assinaturas Digitais. Nova versão do GroupDocs.Signature Cloud 19.5 é lançada.
Verifique as [notas de versão] detalhadas 1 desta versão para ter uma ideia sobre todos os novos recursos/aprimoramentos feitos nesta versão.
O que há de novo
Versão da API - Introduzida a versão API V2
Autenticação - autenticação JWT (JSON Web Token)
API de assinatura - Métodos de API simplificados para criar, verificar e pesquisar assinaturas, assim como obter informações adicionais de documentos
API de arquivo - Métodos introduzidos para upload, download, cópia, movimentação, exclusão de arquivos: documentos de entrada e resultados de renderização, no armazenamento em nuvem
API de pasta - Métodos introduzidos para criar, copiar, mover, excluir pastas no armazenamento em nuvem
API de armazenamento - métodos introduzidos para obter informações de armazenamento e informações de arquivo
Como funciona
A principal mudança neste lançamento é a introdução da versão API V2, é uma nova versão da API. É uma API mais simplificada com menos métodos e opções. Além disso, possui arquitetura interna mais otimizada e refinada. Nesta versão, a API inclui métodos para trabalhar com armazenamento em nuvem. Assim, você pode executar operações de armazenamento usando GroupDocs.Signature Cloud REST API em vez de usar API separada.
Aqui, mostraremos como a versão da API GroupDocs.Signature Cloud V2 funciona e é diferente da V1. Adicionaremos assinatura de código de barras em um documento do Word usando V1 e V2 seguindo estas etapas:
- Recuperar token de acesso
- Carregar documento de origem para armazenamento
- Adicionar assinatura de código de barras ao documento de origem
Você pode observar nos exemplos de cURL a seguir que usamos a autenticação JWT no exemplo V2. Observe que os métodos de autenticação de solicitação de assinatura de URL e OAuth 2.0 da versão API V1 não são mais suportados na V2. Agora, a versão da API V2 oferece suporte à autenticação JWT (JSON Web Token).
No novo método de lançamento, usamos o método File da API V2 para carregar o arquivo no armazenamento, em vez do método GroupDocs.Storage Cloud. E a última diferença dos exemplos a seguir, mas não menos importante, na V2, uma única criação de API é usada para todos os tipos de assinatura suportados, passando os detalhes da assinatura como parâmetro. No entanto, na V1 costumávamos chamar diferentes APIs para cada tipo de assinatura.
V1.1 Exemplo
### 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"}"
Exemplo 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 },} ]}"
Dar uma resposta
Sinta-se à vontade para nos enviar um comentário abaixo, compartilhando suas ideias sobre a nova versão do GroupDocs.Signature Cloud 19.5. Ou visite nosso Fórum de suporte e informe-nos se tiver alguma sugestão ou se precisar de algum recurso/melhoria específico que espera que nossa API tenha.
E se você ainda não teve a chance de experimentar nossa API REST, basta iniciar uma avaliação gratuita hoje. Tudo que você precisa é inscrever-se com o groupdocs.cloud. Depois de se inscrever, você estará pronto para experimentar os poderosos recursos de processamento de arquivos oferecidos pelo groupdocs.cloud.