Skip to content

Commit a90fac4

Browse files
Merge pull request #2484 from syncfusion-content/503504-UG-Updation-HF
503504: Updated UG documentation for Web API
2 parents 94048a1 + 46eedd2 commit a90fac4

18 files changed

+722
-74
lines changed

Document-Processing-toc.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7833,6 +7833,9 @@
78337833
<li>
78347834
<a href="/document-processing/web-apis/consume-apis/organize-pdf">Organize PDF</a>
78357835
</li>
7836+
<li>
7837+
<a href="/document-processing/web-apis/consume-apis/ocr-pdf">OCR PDF</a>
7838+
</li>
78367839
</ul>
78377840
</li>
78387841
</ul>

Document-Processing/Web-apis/consume-apis/compress-pdf.md

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
2-
title: Compress PDF Files Using Syncfusion Web API
2+
title: Compress PDF Files Using Syncfusion Web API
33
description: Reduce PDF file size with image optimization and structural compression while maintaining visual quality using Syncfusion compression Web API.
44
control: general
55
documentation: UG
66
---
7-
# Guide to Compressing PDF Files with Syncfusion API
7+
# Compressing PDF Files Using Syncfusion Web API
88

9-
The Compress PDF API allows you to reduce the size of a PDF document with various compression options.
9+
The Syncfusion Compress PDF Web API reduces the file size of PDF documents while maintaining acceptable visual quality. It optimizes images, fonts, metadata, and internal structures, producing smaller PDFs that are easier to store, share, and distribute. This is especially useful for email sharing, web delivery, and document archiving.
1010

11-
## Flatten PDF Document
11+
## Compress PDF Document
1212

1313
To compress a PDF document, send a request to the /v1/edit-pdf/compress endpoint with the input PDF file and compression options as shown below.
1414

@@ -94,6 +94,38 @@ Console.WriteLine(await response.Content.ReadAsStringAsync());
9494

9595
{% endtabs %}
9696

97+
## Compress PDF settings
98+
99+
**Password**
100+
101+
Specifies the password required to open and process a protected PDF file.
102+
103+
**ImageQuality**
104+
105+
Controls image compression quality. Lower values reduce file size.
106+
107+
**OptimizeFont**
108+
109+
Optimizes and subsets embedded fonts to reduce overall PDF size without affecting text appearance.
110+
111+
**RemoveMetadata**
112+
113+
Removes document metadata such as author, title, and creation details to reduce file size and improve privacy.
114+
115+
**OptimizePageContents**
116+
117+
Optimizes page content by removing unnecessary objects and streamlining internal PDF structures.
118+
119+
**FlattenFormFields**
120+
121+
Converts interactive form fields into static content to further reduce file size.
122+
123+
**FlattenAnnotations**
124+
125+
Converts annotations (such as comments and highlights) into static content to minimize PDF size.
126+
127+
## Compress PDF Job Response
128+
97129
Once the request is sent, it will create a compression job to compress the PDF and return the job details as follows:
98130

99131
```
@@ -104,15 +136,15 @@ Once the request is sent, it will create a compression job to compress the PDF a
104136
}
105137
```
106138

107-
## Poll the status of the Compress PDF Job
139+
## Check Compress PDF Job Status
108140

109141
Next, you can retrieve the job status by sending a request to the /v1/edit-pdf/status/{jobID} endpoint with the job ID.
110142

111143
{% tabs %}
112144

113145
{% highlight c# tabtitle="Curl" %}
114146

115-
curl --location 'http://localhost:8003/v1/conversion/status/9b131bfe-d4eb-4f1d-b946-46443a363eb5' \
147+
curl --location 'http://localhost:8003/v1/edit-pdf/status/9b131bfe-d4eb-4f1d-b946-46443a363eb5' \
116148
--output Output.pdf
117149

118150
{% endhighlight %}
@@ -133,7 +165,7 @@ fetch("http://localhost:8003/v1/edit-pdf/status/4413bbb5-6b26-4c07-9af2-c26cd2c4
133165
{% highlight c# tabtitle="C#" %}
134166

135167
var client = new HttpClient();
136-
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/conversion/status/ef0766ab-bc74-456c-8143-782e730a89df");
168+
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/edit-pdf/status/ef0766ab-bc74-456c-8143-782e730a89df");
137169
var response = await client.SendAsync(request);
138170
response.EnsureSuccessStatusCode();
139171
Console.WriteLine(await response.Content.ReadAsStringAsync());

Document-Processing/Web-apis/consume-apis/delete-pdf-pages.md

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ platform: document-processing
55
control: general
66
documentation: UG
77
---
8-
# How to Delete Pages from a PDF Using Syncfusion API
8+
# Delete Pages from PDF Using Syncfusion Web API
99

10-
This feature allows you to delete pages in a PDF document. To perform this operation, you need to supply a PDF document as input to the Delete Pages API.
10+
The Syncfusion Delete PDF Pages Web API allows you to remove unwanted pages from a PDF document using a simple, API‑driven workflow. You can delete specific pages or page ranges while preserving the original layout, formatting, and quality of the remaining content. This feature is ideal for refining documents, removing sensitive information, or creating customized PDFs for specific use cases.
1111

1212
## Delete PDF Pages
1313

@@ -88,6 +88,26 @@ Console.WriteLine(await response.Content.ReadAsStringAsync());
8888

8989
{% endtabs %}
9090

91+
## Delete PDF pages settings
92+
93+
**Password**
94+
95+
Specifies the password required to open and process a protected PDF file.
96+
97+
**PageRanges**
98+
99+
Defines the page ranges to be deleted from the PDF.
100+
101+
**Start**
102+
103+
Specifies the starting page number of the deletion range.
104+
105+
**End**
106+
107+
Specifies the ending page number of the deletion range.
108+
109+
## Delete Pages Job Response
110+
91111
Once the request is sent, it will create a job to delete PDF pages and return the job details as follows:
92112

93113
```
@@ -98,15 +118,15 @@ Once the request is sent, it will create a job to delete PDF pages and return th
98118
}
99119
```
100120

101-
## Poll the status of the Delete Pages Job
121+
## Check Delete Pages Job Status
102122

103123
Next, you can retrieve the job status by sending a request to the /v1/edit-pdf/status/{jobID} endpoint with the job ID.
104124

105125
{% tabs %}
106126

107127
{% highlight c# tabtitle="Curl" %}
108128

109-
curl --location 'http://localhost:8003/v1/conversion/status/9b131bfe-d4eb-4f1d-b946-46443a363eb5' \
129+
curl --location 'http://localhost:8003/v1/edit-pdf/status/9b131bfe-d4eb-4f1d-b946-46443a363eb5' \
110130
--output Output.pdf
111131

112132
{% endhighlight %}
@@ -128,7 +148,7 @@ fetch("http://localhost:8003/v1/edit-pdf/status/4413bbb5-6b26-4c07-9af2-c26cd2c4
128148
{% highlight c# tabtitle="C#" %}
129149

130150
var client = new HttpClient();
131-
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/conversion/status/ef0766ab-bc74-456c-8143-782e730a89df");
151+
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/edit-pdf/status/ef0766ab-bc74-456c-8143-782e730a89df");
132152
var response = await client.SendAsync(request);
133153
response.EnsureSuccessStatusCode();
134154
Console.WriteLine(await response.Content.ReadAsStringAsync());

Document-Processing/Web-apis/consume-apis/excel-to-pdf.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ platform: document-processing
55
control: general
66
documentation: UG
77
---
8-
# Guide to Excel to PDF Conversion Using Syncfusion API
8+
# Converting Excel to PDF Using Syncfusion Web API
99

10-
Converting an Excel document to PDF is simple. Customize conversion settings, like accessibility and archiving options, to suit your needs.
10+
The Syncfusion Excel to PDF Web API allows you to convert Excel workbooks into well‑formatted, high‑quality PDF files while preserving the structure and readability of worksheets. It supports accurate rendering of data such as tables, formulas (as values), charts, images, and multi‑sheet layouts in the resulting PDF. The conversion can be customized with options like accessibility tagging for assistive technologies and PDF/A compliance for long‑term archiving.
1111

1212
## Convert Excel to PDF
1313

@@ -73,6 +73,16 @@ Console.WriteLine(await response.Content.ReadAsStringAsync());
7373

7474
{% endtabs %}
7575

76+
## Excel to PDF settings
77+
**Password**
78+
79+
Specifies the password required to open a protected Word document before converting it to PDF.
80+
81+
**PdfCompliance**
82+
83+
Defines the PDF/A compliance level for archival and standards adherence. Supported levels include PDF/A‑1B, PDF/A‑2B, PDF/A‑3B, and PDF/A‑4.
84+
85+
## Excel to PDF Job Response
7686
Once the request is sent, it will create a conversion job to convert the Excel document to PDF and return the job details as follows:
7787

7888
```
@@ -82,7 +92,7 @@ Once the request is sent, it will create a conversion job to convert the Excel d
8292
"createdAt": "2024-05-06T09:39:13.9505828Z"
8393
}
8494
```
85-
## Poll the status of the Conversion Job
95+
## Check Excel to PDF Job Status
8696

8797
Next, you can retrieve the job status by sending a request to the /v1/conversion/status/{jobID} endpoint with the job ID.
8898

Document-Processing/Web-apis/consume-apis/flatten-pdf.md

Lines changed: 23 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
2-
title: Flatten PDF Using Syncfusion Web API
2+
title: Flatten PDFs Using Syncfusion Web API
33
description: Flatten annotations, form fields, and signatures to secure PDF content from editing using Syncfusion high‑security flattening Web API.
44
platform: document-processing
55
control: general
66
documentation: UG
77
---
8-
# Guide to Flattening PDFs Using Syncfusion API
8+
# Flattening PDFs Using Syncfusion Web API
99

10-
This feature enables you to flatten annotations and form fields in a PDF document. To use this functionality, you need to provide a PDF document as input to the Flatten PDF API.
10+
The Syncfusion Flatten PDF Web API enables you to permanently embed annotations and form field data into the PDF content. All interactive elements—such as form fields, comments, and highlights—are converted into static, non‑editable content while preserving the document’s appearance. This ensures consistent viewing across devices and makes the PDF suitable for final distribution, archiving, and compliance with workflows.
1111

12-
## Flatten PDF Document
12+
## Flatten PDF Documents
1313

1414
To flatten a PDF document, send a request to the /v1/edit-pdf/flatten endpoint with the input PDF and its options as shown below.
1515

@@ -84,6 +84,22 @@ Console.WriteLine(await response.Content.ReadAsStringAsync());
8484

8585
{% endtabs %}
8686

87+
## Flatten PDFs settings
88+
89+
**Password**
90+
91+
Specifies the password required to open and process a protected PDF file.
92+
93+
**FlattenFormFields**
94+
95+
Converts interactive form fields into static content, making them non‑editable in the output PDF.
96+
97+
**FlattenAnnotations**
98+
99+
Converts annotations (such as comments, highlights, and stamps) into permanent, non‑editable content in the PDF.
100+
101+
## Flatten PDF Job Response
102+
87103
Once the request is sent, it will create a flatten job to flatten the PDF and return the job details as follows:
88104

89105
```
@@ -94,15 +110,15 @@ Once the request is sent, it will create a flatten job to flatten the PDF and re
94110
}
95111
```
96112

97-
## Poll the status of the Flatten Pages Job
113+
## Check Flatten PDF Job Status
98114

99115
Next, you can retrieve the job status by sending a request to the /v1/edit-pdf/status/{jobID} endpoint with the job ID.
100116

101117
{% tabs %}
102118

103119
{% highlight c# tabtitle="Curl" %}
104120

105-
curl --location 'http://localhost:8003/v1/conversion/status/f58c9739-622e-41d4-9dd2-57a901dc13c3' \
121+
curl --location 'http://localhost:8003/v1/edit-pdf/status/f58c9739-622e-41d4-9dd2-57a901dc13c3' \
106122
--output Output.pdf
107123
--header 'Authorization: Bearer {{Placeholder for token}}'
108124

@@ -125,7 +141,7 @@ fetch("http://localhost:8003/v1/edit-pdf/status/4413bbb5-6b26-4c07-9af2-c26cd2c4
125141
{% highlight c# tabtitle="C#" %}
126142

127143
var client = new HttpClient();
128-
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/conversion/status/ef0766ab-bc74-456c-8143-782e730a89df");
144+
var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:8003/v1/edit-pdf/status/ef0766ab-bc74-456c-8143-782e730a89df");
129145
request.Headers.Add("Authorization", "Bearer {{Placeholder for token}}");
130146
var response = await client.SendAsync(request);
131147
response.EnsureSuccessStatusCode();

Document-Processing/Web-apis/consume-apis/html-to-pdf.md

Lines changed: 77 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ platform: document-processing
55
control: general
66
documentation: UG
77
---
8-
# Guide to Converting HTML to PDF Using Syncfusion API
8+
# Converting HTML to PDF Using Syncfusion Web API
99

10-
With the Syncfusion document processing engine, you can easily convert an HTML template or URL to a PDF document. To convert an HTML template to a PDF document, you need to provide both the HTML template file and its assets.
10+
The Syncfusion HTML to PDF Web API allows you to convert web content into high‑quality PDF documents. It supports converting both static HTML templates and live web pages via URLs, ensuring accurate rendering of layouts, styles, images, and fonts. When converting an HTML template, you need to provide the main HTML file along with its dependent assets such as CSS files, images, fonts, and scripts, so the engine can fully render the content as it appears in a browser.
1111

1212
## Convert HTML to PDF
1313

@@ -121,6 +121,80 @@ Console.WriteLine(await response.Content.ReadAsStringAsync());
121121

122122
{% endtabs %}
123123

124+
## HTML to PDF settings
125+
**PaperSize**
126+
127+
Defines the page size for the generated PDF (e.g., A4, Letter).
128+
129+
**Assets**
130+
131+
Specifies additional resources—such as CSS files, images, and fonts—required for converting HTML templates.
132+
133+
**IndexFile**
134+
135+
Indicates the main HTML file that serves as the entry point for the conversion.
136+
137+
**Settings**
138+
139+
Provides rendering and conversion options for the Blink engine used during HTML to PDF processing.
140+
141+
**RenderingEngine**
142+
143+
Specifies the browser engine used to render HTML content before generating the PDF.
144+
145+
**Url**
146+
147+
Defines the source URL or HTML location to be converted into a PDF.
148+
149+
**Orientation**
150+
151+
Defines the page orientation of the PDF, such as Portrait or Landscape.
152+
153+
**Rotation**
154+
155+
Specifies the rotation angle applied to the pages in the generated PDF.
156+
157+
**Margins**
158+
159+
Configures the margin size for all sides of each PDF page.
160+
161+
**AdditionalDelay**
162+
163+
Adds a wait time (in milliseconds) before conversion to ensure dynamic content fully loads.
164+
165+
**EnableLinks**
166+
167+
Preserves active, clickable hyperlinks within the generated PDF.
168+
169+
**EnableScripts**
170+
171+
Allows JavaScript execution during HTML rendering for dynamic content support.
172+
173+
**EnableForms**
174+
175+
Enables interactive form fields in the generated PDF document.
176+
177+
**EnableToc**
178+
179+
Generates a table of contents based on the HTML document structure.
180+
181+
**EnableBookmarks**
182+
183+
Creates PDF bookmarks for easier navigation within the document.
184+
185+
**SinglePagePdf**
186+
187+
Renders the entire HTML content into one continuous PDF page.
188+
189+
**ShowHeader**
190+
191+
Displays header content on each page of the generated PDF.
192+
193+
**ShowFooter**
194+
195+
Displays footer content on each page of the generated PDF.
196+
197+
## HTML to PDF Job Response
124198
To convert HTML to PDF, send a request to the /v1/conversion/html-to-pdf endpoint, including both the HTML file as input and its assets as follows:
125199

126200
{% tabs %}
@@ -254,7 +328,7 @@ Once the request is sent, it will create a conversion job to convert HTML to PDF
254328
}
255329
```
256330

257-
## Poll the status of the Conversion Job
331+
## Check HTML to PDF Job Status
258332

259333
Next, you can retrieve the job status by sending a request to the /v1/conversion/status/{jobID} endpoint with the job ID.
260334

0 commit comments

Comments
 (0)