Хлопці, старі часи, коли ви друкували, підписували, сканували та надсилали документи, минули. Тепер, у цю цифрову еру, можливості онлайн-підпису документів полегшили життя. І GroupDocs.Signature Cloud REST API — перевірений і надійний REST API електронного підпису, який додає можливості електронних підписів у ваші додатки без встановлення програмного забезпечення сторонніх розробників. Це допоможе вам захистити документи в електронному вигляді, застосувавши текст, штамп, QR-код, штрих-код, зображення та цифрові підписи. Випущено нову версію GroupDocs.Signature Cloud 19.5.

Будь ласка, перегляньте докладні примітки до випуску цієї версії, щоб отримати уявлення про всі нові функції/покращення, зроблені в цьому випуску.

Що нового

Версія API - представлена версія API V2

Автентифікація - автентифікація JWT (JSON Web Token).

Signature API - спрощені методи API для створення, перевірки та пошуку підписів, як і отримання додаткової інформації про документи

File API – Представлені методи для завантаження, завантаження, копіювання, переміщення, видалення файлів: вхідні документи та результати візуалізації в хмарному сховищі

Folder API - Представлені методи для створення, копіювання, переміщення та видалення папок у хмарному сховищі

Storage API – представлено методи отримання інформації про зберігання та інформації про файли

Як це працює

Основною зміною в цьому випуску є введення версії API V2, це нова версія API. Це більш спрощений API з меншою кількістю методів і опцій. Крім того, він має більш оптимізовану та вдосконалену внутрішню архітектуру. У цій версії API містить методи роботи з хмарним сховищем. Таким чином, ви можете виконувати операції зберігання за допомогою GroupDocs.Signature Cloud REST API замість використання окремого API.

Тут ми покажемо вам, як працює версія API GroupDocs.Signature Cloud V2, яка відрізняється від V1. Ми додамо підпис штрих-коду в документ Word за допомогою V1 і V2, виконавши такі дії:

Отримати маркер доступу
Завантажте вихідний документ у сховище
Додайте підпис штрих-коду до вихідного документа

Ви можете помітити з наступних прикладів cURL, що ми використовували автентифікацію JWT у прикладі V2. Зауважте, що OAuth 2.0 і методи автентифікації запиту підпису URL-адреси версії API V1 більше не підтримуються у версії V2. Тепер версія API V2 підтримує автентифікацію JWT (JSON Web Token).

У новому методі випуску ми використовували метод File API V2 для завантаження файлу в сховище замість методу 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.

Що нового#

Як це працює#

Забезпечити зворотній звязок#

Що нового

Як це працює

Забезпечити зворотній звязок