Interfejsy API do obsługi plików PDF w chmurze, takie jak CraftMyPDF, wiążą się z podstawowymi problemami, które sprawiają, że nie nadają się one do wielu środowisk produkcyjnych.
Twoje dane opuszczają system: Każdy szablon HTML i ładunek danych JSON jest przesyłany na serwery CraftMyPDF. W przypadku faktur, umów, dokumentacji medycznej lub jakichkolwiek wrażliwych danych biznesowych stwarza to ryzyko związane z nieprzestrzeganiem przepisów HIPAA, RODO i SOC2.
Opóźnienie sieciowe: Każda generacja PDF wiąże się z przejazdem po sieci plus czasem kolejki i renderowania (zazwyczaj sekundami).IronPDF generuje pliki lokalnie w ciągu milisekund.
Koszty na PDF się sumują: Cena oparta na kredytach rośnie wraz z wolumenem — obciążenia o dużej przepustowości powodują znaczne powtarzające się koszty w porównaniu do jednorazowej licencji wieczystej.
Wynik zoptymalizowany pod kątem PRINT: Interfejsy API w chmurze często są zoptymalizowane pod kątem PRINT — redukują tło i upraszczają kolory, aby oszczędzać "atrament". Wynik nigdy nie wygląda tak samo jak kod HTML na ekranie.
**Uzależnienie od szablonu:**CraftMyPDFwymaga korzystania z własnego edytora typu "przeciągnij i upuść". Nie można swobodnie używać standardowego HTML/CSS.
| Aspekt | CraftMyPDF | IronPDF |
|---|---|---|
| Lokalizacja danych | Chmura (Twoje dane opuszczają Twój system) | Lokalnie (dane nigdy nie opuszczają serwera) |
| Opóźnienie | Rundtrip sieciowy + renderowanie (zazwyczaj sekundami) | Milisekundy |
| Ceny | Subskrypcja oparta na kredytach | Jednorazowa Licencja wieczysta |
| System szablonów | Wyłącznie zastrzeżone przeciąganie i upuszczanie | Dowolny kod HTML/CSS/JavaScript |
| Jakość tłumaczenia | Zoptymalizowane pod kątem druku | Renderowanie ekranu z dokładnością do piksela |
| Działa w trybie offline | Nie (wymagane połączenie z Internetem) | Tak |
| Zgodność | Dane opuszczają organizację | Zgodność z SOC2/HIPAA |
| Funkcja | CraftMyPDF | IronPDF |
|---|---|---|
| HTML do PDF | Za pośrednictwem szablonów API | ✅Język ojczysty |
| URL do pliku PDF | Poprzez API | ✅Język ojczysty |
| Szablony niestandardowe | Tylko w edytorze własnościowym | ✅Dowolny kod HTML |
| Obsługa CSS3 | Ograniczone | ✅Pełne |
| Renderowanie JavaScript | Ograniczone | ✅Pełne |
| Łączenie/dzielenie plików PDF | Poprzez API | ✅Język ojczysty |
| Znaki wodne | Poprzez API | ✅Język ojczysty |
| Działa w trybie offline | ❌ | ✅ |
| Własny hosting | ❌ | ✅ |
Upewnij się, że Twoje środowisko spełnia następujące wymagania:
Uruchom te polecenia w katalogu rozwiązania, aby zidentyfikować wszystkie odwołania do CraftMyPDF:
# Find allCraftMyPDFusages in your codebase
grep -r "CraftMyPdf\|craftmypdf\|api.craftmypdf.com" --include="*.cs" .
grep -r "X-API-KEY" --include="*.cs" .
# Find API key references
grep -r "your-api-key\|template-id\|template_id" --include="*.cs" .
# Find NuGet package references
grep -r "CraftMyPdf\|RestSharp" --include="*.csproj" .| Zmiana | CraftMyPDF | IronPDF | Wpływ |
|---|---|---|---|
| Architektura | API REST w chmurze | Lokalna biblioteka .NET | Usuń wywołania HTTP |
| Szablony | Własny edytor | Standardowy HTML | Konwersja szablonów do formatu HTML |
| Klucz API | Wymagane dla każdego wywołania | Licencja przy uruchomieniu | Usuń obsługę klucza API |
| Wzorzec asynchroniczny | Wymagane (HTTP) | Opcjonalnie | Usuń "await", jeśli wolisz |
| Obsługa błędów | Kody statusu HTTP | Wyjątki | Zmiana wzorców try/catch |
| Powiązanie danych | Szablony JSON | Interpolacja ciągów znaków | Uprość powiązanie danych |
Usuń bibliotekę klienta HTTP i zainstaluj IronPDF:
# Remove RestSharp HTTP client
dotnet remove package RestSharp
# Install IronPDF
dotnet add package IronPdfZastąp przestrzenie nazw klienta HTTP przez IronPDF:
// Remove these
using RestSharp;
using System.IO;
// Add this
using IronPdf;Imports IronPdfZastąp nagłówki klucza API dla poszczególnych żądań pojedynczą konfiguracją licencji:
// Add at application startup (Program.cs or Global.asax)
// This replaces all X-API-KEY headers
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add at application startup (Program.vb or Global.asax)
' This replaces all X-API-KEY headers
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"| CraftMyPDF | IronPDF |
|---|---|
POST /v1/create | renderer.RenderHtmlAsPdf(html) |
X-API-KEY header | License.LicenseKey = "..." |
template_id | Standardowy ciąg znaków HTML |
{%name%} placeholders | $"{name}" interpolacja w C# |
POST /v1/merge | PdfDocument.Merge(pdfs) |
POST /v1/add-watermark | pdf.ApplyWatermark(html) |
| Wywołania zwrotne Webhook | Nie jest potrzebne |
| Ograniczanie szybkości | Nie dotyczy |
| OpcjaCraftMyPDF | Odpowiednik IronPDF |
|---|---|
template_id | Ciąg znaków HTML |
data JSON | Interpolacja w języku C# |
page_size: "A4" | PaperSize = PdfPaperSize.A4 |
orientation: "landscape" | PaperOrientation = Landscape |
margin_top: 20 | MarginTop = 20 |
header | HtmlHeader |
footer | HtmlFooter |
Najczęstsza operacja ilustruje fundamentalną zmianę architektury z chmurowego API na renderowanie lokalne.
Wdrożenie CraftMyPDF:
// NuGet: Install-Package RestSharp
using System;
using RestSharp;
using System.IO;
class Program
{
static void Main()
{
var client = new RestClient("https://api.craftmypdf.com/v1/create");
var request = new RestRequest(Method.POST);
request.AddHeader("X-API-KEY", "your-api-key");
request.AddJsonBody(new
{
template_id = "your-template-id",
data = new
{
html = "<h1>Hello World</h1><p>This is a PDF from HTML</p>"
}
});
var response = client.Execute(request);
File.WriteAllBytes("output.pdf", response.RawBytes);
}
}' NuGet: Install-Package RestSharp
Imports System
Imports RestSharp
Imports System.IO
Module Program
Sub Main()
Dim client = New RestClient("https://api.craftmypdf.com/v1/create")
Dim request = New RestRequest(Method.POST)
request.AddHeader("X-API-KEY", "your-api-key")
request.AddJsonBody(New With {
.template_id = "your-template-id",
.data = New With {
.html = "<h1>Hello World</h1><p>This is a PDF from HTML</p>"
}
})
Dim response = client.Execute(request)
File.WriteAllBytes("output.pdf", response.RawBytes)
End Sub
End ModuleWdrożenie IronPDF:
// NuGet: Install-Package IronPdf
using System;
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
pdf.SaveAs("output.pdf");
}
}Imports System
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>")
pdf.SaveAs("output.pdf")
End Sub
End ClassIronPDF eliminuje konfigurację RestClient, nagłówki kluczy API, identyfikatory szablonów i obsługę odpowiedzi HTTP — redukując 15-wierszową operację w chmurze do 4 wierszy kodu lokalnego. Aby uzyskać więcej opcji, zapoznaj się z dokumentacją dotyczącą konwersji HTML do PDF.
Wdrożenie CraftMyPDF:
// NuGet: Install-Package RestSharp
using System;
using RestSharp;
using System.IO;
class Program
{
static void Main()
{
var client = new RestClient("https://api.craftmypdf.com/v1/create");
var request = new RestRequest(Method.POST);
request.AddHeader("X-API-KEY", "your-api-key");
request.AddJsonBody(new
{
template_id = "your-template-id",
data = new
{
url = "https://example.com"
},
export_type = "file" // "file" returns binary PDF; "json" returns a CDN URL
});
var response = client.Execute(request);
File.WriteAllBytes("webpage.pdf", response.RawBytes);
}
}Imports System
Imports RestSharp
Imports System.IO
Module Program
Sub Main()
Dim client As New RestClient("https://api.craftmypdf.com/v1/create")
Dim request As New RestRequest(Method.POST)
request.AddHeader("X-API-KEY", "your-api-key")
request.AddJsonBody(New With {
.template_id = "your-template-id",
.data = New With {
.url = "https://example.com"
},
.export_type = "file" ' "file" returns binary PDF; "json" returns a CDN URL
})
Dim response = client.Execute(request)
File.WriteAllBytes("webpage.pdf", response.RawBytes)
End Sub
End ModuleWdrożenie IronPDF:
// NuGet: Install-Package IronPdf
using System;
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}Imports System
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
End Sub
End ClassMetoda IronPDFRenderUrlAsPdf przechwytuje całą stronę internetową, w tym treści renderowane przez JavaScript. Aby uzyskać więcej opcji, zapoznaj się z dokumentacją dotyczącą konwersji URL na PDF.
Wdrożenie CraftMyPDF:
// NuGet: Install-Package RestSharp
using System;
using RestSharp;
using System.IO;
class Program
{
static void Main()
{
var client = new RestClient("https://api.craftmypdf.com/v1/create");
var request = new RestRequest(Method.POST);
request.AddHeader("X-API-KEY", "your-api-key");
request.AddJsonBody(new
{
template_id = "your-template-id",
data = new
{
html = "<h1>Document Content</h1>",
header = "<div>Page Header</div>",
footer = "<div>Page {page} of {total_pages}</div>"
}
});
var response = client.Execute(request);
File.WriteAllBytes("document.pdf", response.RawBytes);
}
}' NuGet: Install-Package RestSharp
Imports System
Imports RestSharp
Imports System.IO
Module Program
Sub Main()
Dim client As New RestClient("https://api.craftmypdf.com/v1/create")
Dim request As New RestRequest(Method.POST)
request.AddHeader("X-API-KEY", "your-api-key")
request.AddJsonBody(New With {
.template_id = "your-template-id",
.data = New With {
.html = "<h1>Document Content</h1>",
.header = "<div>Page Header</div>",
.footer = "<div>Page {page} of {total_pages}</div>"
}
})
Dim response = client.Execute(request)
File.WriteAllBytes("document.pdf", response.RawBytes)
End Sub
End ModuleWdrożenie IronPDF:
// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
CenterText = "Page Header"
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
{
CenterText = "Page {page} of {total-pages}"
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Document Content</h1>");
pdf.SaveAs("document.pdf");
}
}' NuGet: Install-Package IronPdf
Imports System
Imports IronPdf
Imports IronPdf.Rendering
Module Program
Sub Main()
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
.CenterText = "Page Header"
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter() With {
.CenterText = "Page {page} of {total-pages}"
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Document Content</h1>")
pdf.SaveAs("document.pdf")
End Sub
End ModuleIronPDF obsługuje tokeny zastępcze takie jak {page} i {total-pages} do dynamicznego numerowania stron. Aby uzyskać więcej opcji, zapoznaj się z dokumentacją dotyczącą nagłówków i stopek.
CraftMyPDF wykorzystuje własne symbole zastępcze szablonów, które należy przekształcić na interpolację ciągów znaków w języku C#:
Wzór CraftMyPDF:
//CraftMyPDFtemplate variables
request.AddJsonBody(new
{
template_id = "invoice-template",
data = new
{
customer = "John Doe",
amount = "$1,000",
items = invoiceItems
}
});'CraftMyPDFtemplate variables
request.AddJsonBody(New With {
.template_id = "invoice-template",
.data = New With {
.customer = "John Doe",
.amount = "$1,000",
.items = invoiceItems
}
})Wzór IronPDF:
// C# string interpolation
var html = $@"
<html>
<body>
<h1>Invoice</h1>
<p>Customer: {customerName}</p>
<p>Amount: {amount}</p>
{GenerateItemsTable(invoiceItems)}
</body>
</html>";
var pdf = renderer.RenderHtmlAsPdf(html);Dim html As String = $"
<html>
<body>
<h1>Invoice</h1>
<p>Customer: {customerName}</p>
<p>Amount: {amount}</p>
{GenerateItemsTable(invoiceItems)}
</body>
</html>"
Dim pdf = renderer.RenderHtmlAsPdf(html)Najważniejszą zmianą jest wyeliminowanie zależności sieciowych.IronPDF działa lokalnie — bez RestClient, bez wywołań API, bez obsługi odpowiedzi:
//CraftMyPDF- HTTP required
var client = new RestClient("https://api.craftmypdf.com/v1/create");
var request = new RestRequest(Method.POST);
request.AddHeader("X-API-KEY", "your-api-key");
var response = await client.ExecuteAsync(request);
//IronPDF- no HTTP
var pdf = renderer.RenderHtmlAsPdf(html);Imports RestSharp
'CraftMyPDF- HTTP required
Dim client As New RestClient("https://api.craftmypdf.com/v1/create")
Dim request As New RestRequest(Method.POST)
request.AddHeader("X-API-KEY", "your-api-key")
Dim response = Await client.ExecuteAsync(request)
'IronPDF- no HTTP
Dim pdf = renderer.RenderHtmlAsPdf(html)CraftMyPDF nakłada ograniczenia szybkości API, co wymaga logiki ponownych prób.IronPDF nie ma ograniczeń:
//CraftMyPDF- needed to avoid 429 errors
await Task.Delay(100);
if (response.StatusCode == TooManyRequests) { /* retry */ }
//IronPDF- no limits, just generate
var pdf = renderer.RenderHtmlAsPdf(html);
// Remove all rate limit code!netCraftMyPDF wykorzystuje asynchroniczne webhooki do tworzenia plików PDF.IronPDF działa synchronicznie — plik PDF jest gotowy natychmiast:
//CraftMyPDF- webhook callback required
// POST with webhook_url, wait for callback
//IronPDF- PDF ready immediately
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// No callback needed!'CraftMyPDF- webhook callback required
' POST with webhook_url, wait for callback
'IronPDF- PDF ready immediately
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
' No callback needed!Usuń wzorce async/await, jeśli były one potrzebne wyłącznie do wywołań HTTP:
//CraftMyPDF- async required
var response = await client.ExecuteAsync(request);
//IronPDF- sync by default (async available if needed)
var pdf = renderer.RenderHtmlAsPdf(html);netPo zakończeniu migracji kodu sprawdź, czy:
Przejście zCraftMyPDFna IronPDF eliminuje zależność od chmury, opóźnienia sieciowe, koszty związane z każdym plikiem PDF oraz uzależnienie od szablonów, zapewniając jednocześnie idealne renderowanie w Chromium, które działa w trybie offline. Przejście z wywołań REST API na lokalne wywołania metod upraszcza kod źródłowy i pozwala zachować poufne dane dokumentów w ramach własnej infrastruktury.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
