Füügt PDF Dokument Annotatiounen mat .NET REST API

Am haitegen digitalen Zäitalter sinn PDFs e populäre Format ginn fir Informatioun, Dokumenter a Berichter ze deelen. Wéi och ëmmer, einfach e PDF ze gesinn ass vläicht net genuch fir vill Benotzer. Heiansdo kënnen d’Benotzer Notizen op spezifesch Deeler vum PDF markéieren oder addéieren fir zousätzlech Kontext oder Feedback ze bidden. Glécklecherweis sinn et e puer gratis PDF Annotatoren verfügbar, déi d’Benotzer erlaben einfach Kommentarer ze addéieren, Text ze markéieren, a méi. Wéi och ëmmer, an dësem Artikel wäerte mir entdecken wéi Dir d’REST API benotzt fir PDF Annotatiounen z’ënnerstëtzen, a weisen Iech wéi Dir Notizen op Är PDF Dokumenter markéiert, kommentéiert an bäidréit.

• REST API fir PDF Annotatioun
• Füügt Kommentarer op PDF mat C#
• Füügt Gratis Textannotatioun op PDF mat cURL Kommandoen

REST API fir PDF Annotatioun

Aspose.PDF Cloud bitt eng einfach ze benotzen an ëmfaassend Léisung fir Annotatiounen op PDF Dokumenter programmatesch ze addéieren. Mat Aspose.PDF Cloud kënnt Dir verschidden Aarte vun Annotatiounen op PDF Dokumenter addéieren, dorënner Text, Bild, Stempel a verschidde Markup Annotatiounen. Dir kënnt och existéierend Annotatiounen änneren, sou wéi d’Positioun, d’Gréisst, d’Faarf oder all aner Eegeschaften änneren.

Ënnerstëtzt Annotatiounen enthalen Text, Circle, Polygon, PolyLine, Line, Square, FreeText, Highlight, Underline, Squiggly, StrikeOut, Caret, Ink, Link, Popup, FileAttachment, Sound, Movie, Screen, Widget, Watermark, TrapNet, PrinterMark, Redaktioun, Stamp, RichMedia an PDF3D.

Elo, fir d’SDK an Ärem Projet ze addéieren, sicht w.e.g. Aspose.PDF-Cloud am NuGet Package Manager a klickt op de Add Package Knäppchen. De nächste wichtege Schrëtt ass e Kont iwwer Cloud Dashboard anzeschreiwen an Äre perséinleche Client Umeldungsinformatiounen ze kréien. Kuckt w.e.g. den Quick Start Guide fir weider Detailer.

Füügt Kommentarer op PDF mat C#

Loosst eis e Bléck iwwer de C# .NET Code Snippet kucken, deen benotzt gëtt fir Annotatioun zu engem PDF Dokument ze addéieren.

// Fir komplett Beispiller an Datendateien, gitt w.e.g. op 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Kritt Client Umeldungsinformatioune vun https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// en Objet vun PdfApi erstellen
PdfApi api = new PdfApi(clientSecret, clientID);

// erstellen Lëscht Objet enthalen FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // uginn der véiereckege Regioun Holding FreeTextAnnotation
    // definéieren och Textformatéierungsdetailer
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))
    {
    // Inhalt fir am FreeTextAnnotation ze weisen
    Contents = "Confidential !",
    Color = new Aspose.Pdf.Cloud.Sdk.Model.Color(0, 0, 0, 0),
    Id = "id1",
    Name = "Test Free Text",                    
    Flags = new List<AnnotationFlags> {AnnotationFlags.Default},
    HorizontalAlignment = HorizontalAlignment.Center,
    Intent = FreeTextIntent.FreeTextTypeWriter,
    RichText = "Rich Text",
    Subject = "Text Box Subj",
    ZIndex = 1,
    Justification = Justification.Center,
    Title = "Title",
    PageIndex = 1                     
    }
};
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Elo, loosst de Code Snippet a méi Detailer verstoen.

PdfApi api = new PdfApi(clientSecret, clientID);

Erstellt eng Instanz vun der PdfApi Klass déi Client Umeldungsinformatiounen als Argumenter a sengem Konstruktor hëlt.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Wéi d’API d’Kapazitéit ënnerstëtzt fir eng oder méi Annotatiounen vun ähnlechen Typ zur selwechter Zäit ze addéieren, musse mir e Listobjekt vum FreeTextAnnnotation Typ erstellen.

new FreeTextAnnotation(
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))

Erstellt en Objet vu FreeTextAnnotation wou mir déi rechteckeg Regioun fir Annotatioun an Textformatéierungsdetailer definéieren.

Contents = "Confidential !"

Hei definéiere mir den Inhalt fir FreeTextAnnotation.

var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Rufft d’REST API un fir FreeTextAnnotation op der éischter Säit vum PDF Dokument ze addéieren, deen schonn an der Cloud Storage verfügbar ass.

Hei ënnendrënner sinn déi méiglech Wäerter déi un d’Eegeschafte kënnen zougewisen ginn, déi am uewe genannte Code Snippet benotzt ginn.

• AnnotationFlags - Ënnerstëtzt Wäerter kënnen [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
• Rotatioun - Rotatioun Wénkel fir Text. Méiglech Wäerter kënnen “[Keen, on90, on180, on270]” sinn.
• AnnotationFlags - Eng Rei vu Fändelen déi verschidde Charakteristike vun der Annotatioun spezifizéieren. Méiglech Wäert kann [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
• FreeTextIntent - Enumeréiert d’Intentioune vun der gratis Text Annotatioun. Méiglech Wäerter kënnen [ Undefined, FreeTextCallout, FreeTextTypeWriter] sinn.

Füügt gratis Textannotatioun op PDF mat cURL Kommandoen

D’Benotzung vu cURL Kommandoen fir Aspose ze ruffen.PDF Cloud API ass eng gutt Approche fir dës Ufuerderung z’erreechen. Et ass och gutt wann Dir mat Kommandozeilen Tools vertraut sidd oder se léiwer benotzt. Also, mat dem cURL Kommandozeil Tool, kënnt Dir HTTP Ufroe maachen a verschidde Operatiounen iwwer PDF Dateiveraarbechtung ausféieren.

Elo, fir Annotatiounen zu engem PDF Dokument mat cURL Kommandoen ze addéieren, musse mir als éischt en Authentifikatiounstoken generéieren andeems Dir eng Ufro un den Token Endpunkt mat Ärem App SID an App Key schéckt. Fëllt w.e.g. de folgende Kommando aus fir den AccessToken ze generéieren.

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

Wann den AccessToken generéiert ass, fuert w.e.g. de folgende Kommando aus, deen d’FreeTextAnnotation zum PDF Dokument bäidréit. D’Annotéiert PDF Datei gëtt dann op Cloud Storage aktualiséiert.

curl -v "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/freetext" \
-X POST \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "[  {        \"Color\": {      \"A\": 0,      \"R\": 0,      \"G\": 0,      \"B\": 0    },    \"Contents\": \"Confidential !\",    \"Modified\": \"01/05/2023 12:00:00.000 PM\",    \"Id\": \"id0\",    \"Flags\": [      \"Default\"    ],    \"Name\": \"comment\",    \"Rect\": {      \"LLX\": 100,      \"LLY\": 800,      \"URX\": 350,      \"URY\": 830    },    \"PageIndex\": 0,    \"ZIndex\": 1,    \"HorizontalAlignment\": \"Center\",    \"VerticalAlignment\": \"Center\",    \"CreationDate\": \"03/05/2023 16:00:00.000 PM\",    \"Subject\": \"Subj.\",    \"Title\": \"Main Heading\",    \"RichText\": \"Hello world...\",    \"Justification\": \"Left\",    \"Intent\": \"FreeTextTypeWriter\",    \"Rotate\": \"None\",    \"TextStyle\": {      \"FontSize\": 26,      \"Font\": \"Arial\",      \"ForegroundColor\": {        \"A\": 10,        \"R\": 10,        \"G\": 100,        \"B\": 120      },      \"BackgroundColor\": {        \"A\": 0,        \"R\": 0,        \"G\": 50,        \"B\": 80      }    }  }]"

Ersetzen {inputPDF} mam Numm vun der Input PDF-Datei scho verfügbar op Cloud-Speicher, {accessToken} mam JWT-Zougangstoken uewen generéiert.

D’PDF Dokument dat am uewe genannte Beispill benotzt gëtt, ka vun [dësem Link] erofgeluede ginn (https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet/blob/master/testData/Binder1.pdf).

Conclusioun

Als Schlussfolgerung, d’Annotatiounen op PDFs bäizefügen kënnen hir Nëtzlechkeet a Funktionalitéit staark verbesseren. Egal ob Dir sicht wichtegen Text ze markéieren, Kommentarer ze addéieren oder Notizen direkt am Dokument ze huelen, dann ass Aspose.PDF Cloud eng erstaunlech Wiel fir dëst z’erreechen. Mir hunn och geléiert datt Aspose.PDF Cloud SDK fir .NET a cURL Kommandoen mächteg Léisunge fir PDFs annotéieren ubidden, wat Iech d’Méiglechkeet gëtt personaliséiert Workflows an Automatisatiounsprozesser ze kreéieren. Dofir, mat dësen Tools, kënnt Dir séier an einfach Annotatiounen op PDFs addéieren, wärend Dir Zäit spuert an d’Produktivitéit erhéicht.

Nëtzlech Linken

• API Referenz
• Entwéckler Guide
• SDK Source Code
• Free Support Forum
• Live Demos

Zesummenhang Artikelen

Mir recommandéieren Iech duerch déi folgend Blogs ze goen:

• Wuert zu TIFF Dokument Konversioun mat .NET REST API
• Wéi entwéckelen RTF zu PDF Konverter mat .NET REST API
• Wéi addéiere mer eng digital Ënnerschrëft op Excel Dateien mat .NET Cloud SDK