Chłopaki, dawno nie było żmudnej pracy polegającej na podpisaniu dokumentu, kiedy drukowałeś, podpisywałeś, skanowałeś i wysyłałeś dokumenty. Teraz, w epoce cyfrowej, opcje podpisywania dokumentów online ułatwiły życie. A GroupDocs.Signature Cloud REST API to przetestowany i niezawodny interfejs API REST e-Signature, który zwiększa moc podpisów elektronicznych w Twoich aplikacjach bez instalowania oprogramowania innych firm. Pomaga elektronicznie zabezpieczyć dokumenty, stosując tekst, pieczęć, kod QR, kod kreskowy, obraz i podpisy cyfrowe. Wydano nową wersję GroupDocs.Signature Cloud 19.5.
Sprawdź szczegółowe uwagi do wydania tej wersji, aby dowiedzieć się o wszystkich nowych funkcjach/ulepszeniach wprowadzonych w tej wersji.
Co nowego
Wersja API — wprowadzono wersję API V2
Uwierzytelnianie — uwierzytelnianie JWT (JSON Web Token).
Signature API - Uproszczone metody API do tworzenia, weryfikowania i wyszukiwania podpisów, takie same jak uzyskiwanie dodatkowych informacji o dokumentach
File API – Wprowadzono metody przesyłania, pobierania, kopiowania, przenoszenia, usuwania plików: dokumenty wejściowe i wyniki renderowania w chmurze
Folder API — Wprowadzono metody tworzenia, kopiowania, przenoszenia i usuwania folderów w chmurze
Interfejs API magazynu — wprowadzono metody uzyskiwania informacji o magazynie i plikach
Jak to działa
Główną zmianą w tej wersji jest wprowadzenie wersji V2 API, jest to całkowicie nowa wersja API. Jest to bardziej uproszczony interfejs API z mniejszą liczbą metod i opcji. Ponadto ma bardziej zoptymalizowaną i udoskonaloną architekturę wewnętrzną. W tej wersji API zawiera metody pracy z pamięcią masową w chmurze. Możesz więc wykonywać operacje przechowywania przy użyciu interfejsu API GroupDocs.Signature Cloud REST zamiast korzystania z oddzielnego interfejsu API.
Tutaj pokażemy Ci, jak działa wersja API GroupDocs.Signature Cloud V2 i różni się ona od wersji V1. Dodamy podpis kodu kreskowego w dokumencie programu Word przy użyciu V1 i V2, wykonując następujące kroki:
- Pobierz token dostępu
- Prześlij dokument źródłowy do magazynu
- Dodaj podpis kodu kreskowego do dokumentu źródłowego
Z poniższych przykładów cURL możesz zauważyć, że użyliśmy uwierzytelniania JWT w przykładzie V2. Uwaga: OAuth 2.0 i metody uwierzytelniania żądania podpisania adresu URL wersji V1 API nie są już obsługiwane w wersji 2. Teraz wersja V2 API obsługuje uwierzytelnianie JWT (JSON Web Token).
W nowej metodzie wydania użyliśmy metody File z V2 API do przesyłania plików do magazynu zamiast metody GroupDocs.Storage Cloud. I ostatnia różnica w porównaniu z poniższymi przykładami, ale nie mniej ważna, w wersji V2 dla wszystkich obsługiwanych typów podpisów używane jest tworzenie pojedynczego interfejsu API, przekazując szczegóły podpisu jako parametr. Jednak w wersji 1 używaliśmy różnych interfejsów API dla każdego typu podpisu.
V1.1 Przykład
### 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"}"
Wersja 2.0 Przykład
### 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 },} ]}"
Przekazać opinię
Zachęcamy do pozostawienia nam komentarza poniżej i podzielenia się swoimi przemyśleniami na temat nowej wersji GroupDocs.Signature Cloud 19.5. Lub odwiedź nasze Forum pomocy technicznej i daj nam znać, jeśli masz jakieś sugestie lub potrzebujesz konkretnych funkcji/ulepszeń, których oczekujesz od naszego interfejsu API.
A jeśli jeszcze nie miałeś okazji wypróbować naszego REST API, po prostu rozpocznij bezpłatny okres próbny już dziś. Wszystko, czego potrzebujesz, to zarejestrować się w groupdocs.cloud. Po zarejestrowaniu się możesz wypróbować zaawansowane funkcje przetwarzania plików oferowane przez groupdocs.cloud.