ข่าวดีสำหรับนักพัฒนา! เปิดตัว GroupDocs.Annotation Cloud 19.5 ใหม่ทั้งหมด เรามุ่งมั่นที่จะพัฒนา GroupDocs.Annotation Cloud REST API เพื่อทำให้ง่ายขึ้นและใช้งานง่ายขึ้น ด้วยเหตุนี้ เราจึงทำการเปลี่ยนแปลงที่จำเป็นในเวอร์ชันนี้ API ใหม่ได้รับการปรับให้เหมาะสมยิ่งขึ้นด้วยวิธีการและตัวเลือกที่น้อยลง สถาปัตยกรรมภายในได้รับการปรับปรุงใหม่สำหรับการประมวลผลที่รวดเร็วและเชื่อถือได้เพื่อสร้างเครื่องมือคำอธิบายประกอบเอกสารและรูปภาพพร้อมรองรับการดำเนินการบันทึกย่อตามข้อความและรูปภาพ ตอนนี้ API รวมถึงวิธีการทำงานกับที่เก็บข้อมูลบนคลาวด์ คุณจึงสามารถดำเนินการจัดเก็บโดยใช้ GroupDocs.Annotation Cloud REST API ได้โดยตรงแทนที่จะใช้ API แยกต่างหาก
โปรดตรวจสอบรายละเอียด releasenotes ของเวอร์ชันนี้ เพื่อรับแนวคิดเกี่ยวกับคุณลักษณะ/การปรับปรุงใหม่ทั้งหมดที่เกิดขึ้นในเวอร์ชันนี้
#ทำลายการเปลี่ยนแปลง
เวอร์ชัน API ใหม่
เปิดตัว API เวอร์ชัน V2 ในเวอร์ชัน 19.5 V1 จะยังคงใช้งานได้
การรับรองความถูกต้อง
การรับรองความถูกต้อง JWT (JSON Web Token) ได้รับการแนะนำในรุ่นนี้ ตอนนี้วิธีการตรวจสอบความถูกต้องแบบ OAuth2 และ URL Signing ล้าสมัยแล้ว
API คำอธิบายประกอบ
วิธี API แบบง่ายเพื่อใช้คำอธิบายประกอบแบบข้อความและรูปภาพกับเอกสารและรูปภาพในรูปแบบยอดนิยมทั้งหมด
API ที่เก็บข้อมูล
File API – แนะนำวิธีการอัปโหลด ดาวน์โหลด คัดลอก ย้าย ลบไฟล์: ป้อนเอกสารและแสดงผลในที่เก็บข้อมูลบนคลาวด์
Folder API - แนะนำวิธีการสร้าง คัดลอก ย้าย ลบโฟลเดอร์ในที่เก็บข้อมูลบนคลาวด์
Storage API - แนะนำวิธีการรับข้อมูลพื้นที่เก็บข้อมูลและข้อมูลไฟล์
เพิ่มคำอธิบายประกอบในเอกสาร
ที่นี่เราจะแสดงให้คุณเห็นว่า GroupDocs.Annotation Cloud V2 API ทำงานอย่างไรและแตกต่างจาก V1 เราจะเพิ่มคำอธิบายประกอบในเอกสาร Word โดยใช้ GroupDocs.Annotation Cloud SDK สำหรับ .NET โดยทำตามขั้นตอนเหล่านี้:
- อัปโหลดเอกสารต้นฉบับไปยังที่เก็บข้อมูล
- เพิ่มคำอธิบายประกอบในเอกสารต้นฉบับ
เราจำเป็นต้องอัปโหลดเอกสารต้นฉบับไปยังที่เก็บข้อมูลบนคลาวด์ ในตัวอย่างนี้เราจะประมวลผลเอกสารจากที่เก็บข้อมูลบนคลาวด์ ในการเปิดตัวครั้งนี้ เราได้เปิดตัว File API สำหรับการจัดเก็บไฟล์ เราจะใช้เมธอด UploadFile ของเวอร์ชัน Annotation V2 API แทนเมธอด GroupDocs.Storage Cloud API เพื่ออัปโหลดไฟล์ไปยังที่เก็บข้อมูล
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
{
// อัพโหลดไฟล์
class Upload_File
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new FileApi(configuration);
try
{
// เปิดไฟล์ใน IOStream จากในเครื่อง/ดิสก์
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);
}
}
}
}
ในเวอร์ชัน 19.5 วิธี PUT สำหรับการนำเข้าคำอธิบายประกอบได้เปลี่ยนเป็นวิธี POST ดังที่แสดงในโค้ดตัวอย่างต่อไปนี้
ตัวอย่าง V1.1
//สิ่งที่ต้องทำ: รับ AppSID และ AppKey ของคุณที่ https://dashboard.groupdocs.cloud (ต้องลงทะเบียนฟรี)
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,
};
// แทรก/ส่งออกคำอธิบายประกอบไปยังเอกสาร
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
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
{
// โพสต์/เพิ่มคำอธิบายประกอบ
class Add_Annotation
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new AnnotateApi(configuration);
try
{
// ตั้งคำขอ
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);
}
}
}
}
แบ่งปันความคิดเห็นของคุณ
ความคิดเห็นของคุณมีความสำคัญ! โปรดอย่าลังเลที่จะส่ง ความคิดเห็น แบ่งปันความคิดเห็นของคุณเกี่ยวกับ GroupDocs.Annotation Cloud REST API เวอร์ชันใหม่ ช่วยให้เราสามารถปรับปรุงและปรับแต่ง API ของเราได้อย่างต่อเนื่อง