Các bạn, công việc ký tên vào một tài liệu tẻ nhạt ngày xưa đã không còn nữa, khi bạn từng in, ký, quét và đăng tài liệu. Giờ đây, trong kỷ nguyên kỹ thuật số này, các tùy chọn ký tài liệu trực tuyến đã giúp cuộc sống trở nên dễ dàng hơn. Và API REST của GroupDocs.Signature Cloud là API REST của chữ ký điện tử đã được thử nghiệm và đáng tin cậy để bổ sung sức mạnh của chữ ký điện tử trong các ứng dụng của bạn mà không cần cài đặt bất kỳ phần mềm bên thứ ba nào. Nó giúp bạn bảo mật điện tử các tài liệu của mình bằng cách áp dụng Văn bản, Dấu, Mã QR, Mã vạch, Hình ảnh và Chữ ký số. Phiên bản mới của GroupDocs.Signature Cloud 19.5 được phát hành.
Vui lòng kiểm tra ghi chú phát hành chi tiết của phiên bản này để biết ý tưởng về tất cả các tính năng/cải tiến mới được thực hiện trong bản phát hành này.
Có gì mới
Phiên bản API - Giới thiệu phiên bản API V2
Xác thực - Xác thực JWT(JSON Web Token)
API chữ ký - Các phương thức API đơn giản hóa để tạo, xác minh và tìm kiếm chữ ký, giống như lấy thông tin bổ sung của tài liệu
API tệp – Giới thiệu các phương pháp tải lên, tải xuống, sao chép, di chuyển, xóa tệp: tài liệu đầu vào và kết xuất kết quả, trong bộ lưu trữ đám mây
API thư mục - Giới thiệu các phương pháp tạo, sao chép, di chuyển, xóa thư mục trong kho lưu trữ đám mây
API lưu trữ - Các phương pháp được giới thiệu để lấy thông tin lưu trữ và thông tin tệp
Làm thế nào nó hoạt động
Thay đổi chính trong phiên bản này là việc giới thiệu phiên bản API V2, đây là phiên bản API hoàn toàn mới. Đó là API đơn giản hóa hơn với ít phương thức và tùy chọn hơn. Ngoài ra, nó có kiến trúc bên trong được tối ưu hóa và tinh tế hơn. Trong phiên bản này, API bao gồm các phương pháp để làm việc với lưu trữ đám mây. Vì vậy, bạn có thể thực hiện các thao tác lưu trữ bằng GroupDocs.Signature Cloud REST API thay vì sử dụng API riêng biệt.
Sau đây, chúng tôi sẽ giới thiệu cho bạn cách thức hoạt động của phiên bản API GroupDocs.Signature Cloud V2 và nó khác với phiên bản V1. Chúng tôi sẽ thêm chữ ký mã vạch trong tài liệu Word bằng V1 và V2 bằng cách thực hiện theo các bước sau:
- Truy xuất mã thông báo truy cập
- Tải tài liệu nguồn lên Bộ lưu trữ
- Thêm chữ ký mã vạch vào tài liệu nguồn
Bạn có thể nhận thấy từ các ví dụ cURL sau đây rằng chúng tôi đã sử dụng xác thực JWT trong ví dụ V2. Xin lưu ý rằng các phương thức xác thực yêu cầu ký tên OAuth 2.0 và URL của phiên bản API V1 không còn được hỗ trợ trong V2 nữa. Giờ đây, phiên bản API V2 hỗ trợ xác thực JWT(JSON Web Token).
Trong phương thức phát hành mới, chúng tôi đã sử dụng phương thức Tệp của API V2 để tải tệp lên bộ lưu trữ thay vì phương thức GroupDocs.Storage Cloud. Và sự khác biệt cuối cùng so với các ví dụ sau, nhưng không kém phần quan trọng, trong V2, một API tạo duy nhất được sử dụng cho tất cả các loại chữ ký được hỗ trợ bằng cách chuyển các chi tiết chữ ký làm tham số. Tuy nhiên, trong V1, chúng tôi thường gọi các API khác nhau cho từng loại chữ ký.
V1.1 Ví dụ
### 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 Ví dụ
### 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 },} ]}"
Cung cấp phản hồi
Vui lòng gửi cho chúng tôi một nhận xét bên dưới để chia sẻ suy nghĩ của bạn về phiên bản mới của GroupDocs.Signature Cloud 19.5. Hoặc truy cập Diễn đàn hỗ trợ của chúng tôi và cho chúng tôi biết nếu bạn có bất kỳ đề xuất nào hoặc nếu bạn cần bất kỳ tính năng/cải tiến cụ thể nào mà bạn mong đợi API của chúng tôi sẽ có.
Và nếu bạn chưa có cơ hội dùng thử API REST của chúng tôi, chỉ cần bắt đầu dùng thử miễn phí ngay hôm nay. Tất cả những gì bạn cần là đăng ký với groupdocs.cloud. Sau khi đăng ký, bạn đã sẵn sàng dùng thử các tính năng xử lý tệp mạnh mẽ do groupdocs.cloud cung cấp.