伙计们，过去打印、签署、扫描和邮寄文件的繁琐的签署文件的工作已经一去不复返了。现在，在这个数字时代，在线文档签名选项使生活变得更加轻松。 GroupDocs.Signature Cloud REST API 经过测试且可靠的电子签名 REST API，可在您的应用程序中添加电子签名的功能，而无需安装任何第三方软件。它可以通过应用文本、图章、QR 码、条形码、图像和数字签名来帮助您以电子方式保护文档。 GroupDocs.Signature Cloud 19.5新版本发布。
请查看此版本的详细发行说明，以了解此版本中的所有新功能/增强功能。
什么是新的
API版本 - 推出API版本V2
身份验证 - JWT(JSON Web Token) 身份验证
签名 API - 用于创建、验证和搜索签名的简化 API 方法，与获取文档的附加信息相同
文件API – 引入了上传、下载、复制、移动、删除文件的方法：输入文档和渲染结果，在云存储中
文件夹 API - 引入了在云存储中创建、复制、移动、删除文件夹的方法
Storage API - 引入了获取存储信息和文件信息的方法
怎么运行的
此版本的主要变化是引入了V2 API版本，它是全新的API版本。它是更简化的 API，具有更少的方法和选项。同时，其内部架构也更加优化和精致。在此版本中，API 包含使用云存储的方法。因此，您可以使用 GroupDocs.Signature Cloud REST API 执行存储操作，而不是使用单独的 API。
这里我们将向您展示 GroupDocs.Signature Cloud V2 API 版本的工作原理，它与 V1 有所不同。我们将按照以下步骤使用 V1 和 V2 在 Word 文档中添加条形码签名：
- 检索访问令牌
- 将源文档上传至存储
- 将条形码签名添加到源文档
从以下 cURL 示例中您可以注意到，我们在 V2 示例中使用了 JWT 身份验证。请注意，V2 不再支持 V1 API 版本的 OAuth 2.0 和 URL 签名请求身份验证方法。现在，V2 API 版本支持 JWT(JSON Web Token) 身份验证。
在新的发布方法中，我们使用V2 API的File方法将文件上传到存储，而不是GroupDocs.Storage Cloud方法。最后一个与以下示例的区别(但并非最不重要)是，在 V2 中，通过将签名详细信息作为参数传递，可以将单个 API 创建用于所有支持的签名类型。然而，在 V1 中，我们习惯于为每种签名类型调用不同的 API。
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"}"
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 },} ]}"
提供反馈信息
请随时在下面发表评论，分享您对新版本 GroupDocs.Signature Cloud 19.5 的想法。或者访问我们的支持论坛，如果您有任何建议或者您希望我们的 API 具有任何特定功能/改进，请告诉我们。
如果您还没有机会尝试我们的 REST API，请立即开始免费试用。您所需要的只是注册 groupdocs.cloud。注册后，您就可以尝试 groupdocs.cloud 提供的强大文件处理功能。