Tiltify.Client 0.1.3-dev7

Tiltify.Client

A modern, async-first .NET 10 client library for the Tiltify v5 API, featuring:

• Kiota-generated typed REST client from the official OpenAPI spec
• OAuth client credentials per call, with tokens cached per client and refreshed before expiry
• Webhook signature verification (HMAC-SHA256 + Base64 using Agash.Webhook.Abstractions)
• Typed webhook event models for donations, facts/milestones, and more
• Dependency injection extensions for easy registration
• Native AOT compatible

Packages

Quick Start

// Register services
services.AddTiltifyClient();

// Create a client for an application's credentials; tokens are cached per client ID
var factory = serviceProvider.GetRequiredService<ITiltifyClientFactory>();
var client = factory.CreateApiClient(new TiltifyCredentials("your-client-id", "your-client-secret"));
var polls = await client.Api.Public.Campaigns["campaign-id"].Polls.GetAsync();
foreach (Poll poll in polls?.Data ?? [])
{
    Console.WriteLine($"{poll.Name}: {poll.AmountRaised?.Value} {poll.AmountRaised?.Currency}");
}

// Handle webhooks
var handler = serviceProvider.GetRequiredService<ITiltifyWebhookHandler>();
var result = await handler.HandleAsync(webhookRequest, new TiltifyWebhookOptions
{
    SigningSecret = "your-webhook-signing-secret",
});

if (result.IsAuthenticated && result.Event is TiltifyDonationWebhookEvent donation)
{
    Console.WriteLine($"Donation: {donation.Data.DonorName} — {donation.Data.Amount.Value} {donation.Data.Amount.Currency}");
}

HTTP

Every request, token and API, goes through the IHttpClientFactory client named TiltifyClientFactory.HttpClientName, which AddTiltifyClient sets up with Kiota's default middleware (retry, redirect, compression). Add a proxy or your own handlers with services.AddHttpClient(TiltifyClientFactory.HttpClientName).

Typed list responses

Tiltify's OpenAPI document leaves the items of every paginated list untyped. scripts/regen-kiota.sh runs scripts/patch-openapi.cs first, which types each list from its example, so Polls, Rewards, Milestones, Donations and the rest come back as typed Data lists.

Webhook Signature Verification

Tiltify signs webhook deliveries using HMAC-SHA256. The signed string is {X-Tiltify-Timestamp}.{rawBody}, and the signature is Base64-encoded. This library verifies that automatically using the configured signing secret.

License

MIT