Paperwright.Sdk
0.1.0
dotnet add package Paperwright.Sdk --version 0.1.0
NuGet\Install-Package Paperwright.Sdk -Version 0.1.0
<PackageReference Include="Paperwright.Sdk" Version="0.1.0" />
<PackageVersion Include="Paperwright.Sdk" Version="0.1.0" />
<PackageReference Include="Paperwright.Sdk" />
paket add Paperwright.Sdk --version 0.1.0
#r "nuget: Paperwright.Sdk, 0.1.0"
#:package Paperwright.Sdk@0.1.0
#addin nuget:?package=Paperwright.Sdk&version=0.1.0
#tool nuget:?package=Paperwright.Sdk&version=0.1.0
Paperwright.Sdk
Official .NET client for the Paperwright PDF rendering API. Render stored templates or inline content to PDF from your backend with an API key.
The API key is a server-side credential. Never embed it in browser or mobile clients — anyone who extracts it can render against your workspace.
Install
dotnet add package Paperwright.Sdk
Quick start
using Paperwright.Sdk;
var client = new PaperwrightClient("pdfly_your_key_here");
// Render a stored template by id
byte[] pdf = await client.RenderTemplateAsync(
templateId: Guid.Parse("1d3a734b-0647-491a-9f79-359b0d83b2aa"),
data: new { name = "Ali", total = 91.50m });
await File.WriteAllBytesAsync("invoice.pdf", pdf);
Inline rendering
Render the designer's JSON document directly, without storing it first:
byte[] pdf = await client.RenderInlineAsync(templateJson, new { name = "Ali" });
Dependency injection (recommended for web apps)
Registers PaperwrightClient as a typed HttpClient so it benefits from
connection pooling and IHttpClientFactory lifetimes:
builder.Services.AddPaperwright(o =>
{
o.ApiKey = builder.Configuration["Paperwright:ApiKey"]!;
// o.BaseUrl = "http://localhost:5110"; // for local/self-hosted
});
// then inject PaperwrightClient anywhere
public class InvoiceService(PaperwrightClient pdfly) { /* ... */ }
Error handling
Non-success responses throw PaperwrightException with the HTTP StatusCode:
try
{
var pdf = await client.RenderTemplateAsync(id, data);
}
catch (PaperwrightException ex) when (ex.StatusCode == HttpStatusCode.Unauthorized)
{
// invalid or revoked API key
}
Configuration
| Option | Default | Notes |
|---|---|---|
ApiKey |
(required) | The pdfly_… key from your dashboard |
BaseUrl |
https://api.paperwright.dev |
Override for self-hosted/local |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net8.0
- Microsoft.Extensions.Http (>= 8.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0 | 126 | 6/12/2026 |