Tin tuyệt vời cho các nhà phát triển! Tất cả GroupDocs.Annotation Cloud 19.5 mới được giới thiệu. Chúng tôi cam kết phát triển GroupDocs.Annotation Cloud REST API để đơn giản hóa và dễ sử dụng hơn. Với suy nghĩ này, chúng tôi đã thực hiện những thay đổi cần thiết trong phiên bản này. API mới được tối ưu hóa hơn với ít phương thức và tùy chọn hơn. Kiến trúc bên trong của nó được cải tiến để xử lý nhanh và đáng tin cậy nhằm xây dựng các công cụ Chú thích Tài liệu & Hình ảnh với sự hỗ trợ cho các thao tác chú thích dựa trên Văn bản & Hình. Ngoài ra, bây giờ 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ể trực tiếp thực hiện các thao tác lưu trữ bằng GroupDocs.Annotation Cloud REST API thay vì sử dụng API riêng biệt.
Vui lòng kiểm tra chi tiết ghi chú phát hành 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.
Thay đổi đột phá
Phiên bản API mới
Phiên bản API V2 được giới thiệu trong phiên bản 19.5, V1 sẽ vẫn khả dụng.
xác thực
Xác thực JWT (JSON Web Token) được giới thiệu trong bản phát hành này, hiện tại các phương thức xác thực ký tên OAuth2 và URL đã lỗi thời.
API chú thích
Các phương pháp API được đơn giản hóa để áp dụng các chú thích dựa trên Văn bản và Hình ảnh cho các tài liệu và hình ảnh ở tất cả các định dạng phổ biến.
API lưu trữ
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 : nhập tài liệu và hiển thị kết quả, trong bộ lưu trữ đám mây
Folder API - Giới thiệu các phương pháp tạo, sao chép, di chuyển, xóa thư mục trong bộ nhớ đám mây
API lưu trữ - Giới thiệu các phương pháp lấy thông tin lưu trữ và thông tin tệp
Thêm chú thích vào tài liệu
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.Annotation Cloud V2 và nó khác với phiên bản V1. Chúng tôi sẽ thêm chú thích trong tài liệu Word bằng cách sử dụng GroupDocs.Annotation Cloud SDK cho .NET bằng cách thực hiện theo các bước sau:
- Tải tài liệu nguồn lên Bộ lưu trữ
- Thêm chú thích vào tài liệu nguồn
Chúng tôi cần tải tài liệu nguồn lên Lưu trữ đám mây vì trong ví dụ này, chúng tôi sẽ xử lý tài liệu từ Lưu trữ đám mây. Trong bản phát hành, chúng tôi đã giới thiệu API tệp cho các hoạt động lưu trữ tệp. Chúng tôi sẽ sử dụng phương thức UploadFile của phiên bản Annotation V2 API thay vì phương thức GroupDocs.Storage Cloud API để tải tệp lên bộ lưu trữ.
using System;
using System.IO;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;
namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
// Cập nhật dử liệu
class Upload_File
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new FileApi(configuration);
try
{
// Mở tệp trong IOStream từ cục bộ/đĩa.
var fileStream = File.Open("..\\..\\..\\Data\\Annotationdocs\\one-page.docx", FileMode.Open);
var request = new UploadFileRequest("Annotationdocs/one-page1.docx", fileStream, Common.MyStorage);
var response = apiInstance.UploadFile(request);
Console.WriteLine("Expected response type is FilesUploadResult: " + response.Uploaded.Count.ToString());
}
catch (Exception e)
{
Console.WriteLine("Exception while calling FileApi: " + e.Message);
}
}
}
}
Trong phiên bản 19.5, phương thức PUT để nhập chú thích đã được thay đổi thành phương thức POST, như thể hiện trong mã mẫu sau.
V1.1 Ví dụ
//VIỆC CẦN LÀM: Nhận AppSID và AppKey của bạn tại https://dashboard.groupdocs.cloud (yêu cầu đăng ký miễn phí).
var configuration = new Configuration
{
AppSid = Sid,
AppKey = Key
};
var apiInstance = new AnnotationApi(configuration);
try
{
List<AnnotationInfo> annotations = new List<AnnotationInfo>();
AnnotationInfo annotation = new AnnotationInfo
{
AnnotationPosition = new Point(852, 154.31),
Replies = new[]
{
new AnnotationReplyInfo {Message = "reply text", RepliedOn = DateTime.Now, UserName = "Admin"},
new AnnotationReplyInfo
{
Message = "reply2 text",
RepliedOn = DateTime.Now,
UserName = "Commentator"
}
},
Box = new Rectangle((float)173.29, (float)154.31, (float)142.5, 9),
PageNumber = 0,
SvgPath =
"[{\"x\":173.2986,\"y\":687.5769},{\"x\":315.7985,\"y\":687.5769},{\"x\":173.2986,\"y\":678.5769},{\"x\":315.7985,\"y\":678.5769}]",
Type = AnnotationType.Text,
CreatorName = "Anonym A."
};
annotations.Add(annotation);
PutExportRequest request = new PutExportRequest()
{
Name ="Annotated.pdf",
Folder=null,
Password=null,
Body=annotations,
};
// Chèn/Xuất chú thích vào tài liệu.
var response = apiInstance.PutExport(request);
Debug.Print("Document Processsed and stream length: " + response.Length);
}
catch (Exception e)
{
Debug.Print("Exception when inserting Annotation to document: " + e.Message);
}
V2.0 Ví dụ
using System;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;
namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
// Đăng/Thêm chú thích
class Add_Annotation
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new AnnotateApi(configuration);
try
{
// Đặt yêu cầu.
var request = new PostAnnotationsRequest()
{
filePath = "Annotationdocs\\ten-pages.docx",
annotations = new System.Collections.Generic.List<AnnotationInfo>() {
new AnnotationInfo
{
AnnotationPosition = new Point { X = 852, Y = 59.388262910798119 },
Box = new Rectangle { X = 375.89276123046875, Y = 59.388263702392578, Width = 88.7330551147461, Height = 37.7290153503418 },
PageNumber = 0,
PenColor = 1201033,
PenStyle = 0,
PenWidth = 1,
Type = AnnotationInfo.TypeEnum.Area,
CreatorName = "Anonym A."
}
}
};
apiInstance.PostAnnotations(request);
Console.WriteLine("Expected response type is void: Annotation added.");
}
catch (Exception e)
{
Console.WriteLine("Exception while calling Annotation AnnotateApi: " + e.Message);
}
}
}
}
Chia sẻ phản hồi của bạn
Phản hồi của bạn rất quan trọng! Vui lòng gửi cho chúng tôi một nhận xét chia sẻ suy nghĩ của bạn về phiên bản mới của API GroupDocs.Annotation Cloud REST. Nó giúp chúng tôi liên tục cải thiện và tinh chỉnh API của mình.