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.