RedirectPizza.NET

A way to interact with redirect.pizza's api in c sharp.

You can either clone the source code or install it using NuGet.

Usage

const apiToken = "XXXXXX";  // You can find this token on https://redirect.pizza/api
var pizza = new RedirectPizza.NET.RedirectPizza(apiToken);

Endpoints

• Redirects
• EmailForwards
• Team
• Domains

Metadata

The ListRedirects() and ListEmailForwards() methods return two things: The Items and Meta information. The meta property contains things like the current page, the next page number and the amount of pages. This makes it easy to add pages to your application.

var redirects = pizza.Redirects.ListRedirects();

Console.WriteLine($"Current page: {redirects.Meta.CurrentPage}"); // Current page: 1

Examples

Each property, method and field is documented with <summary></summary> tags. Your IDE should automatically add intellisense to everything.

Redirects

List all redirects

var redirects = pizza.Redirects.ListRedirects();
// or asynchronously 
var redirects = await pizza.Redirects.ListRedirectsAsync();

List all redirects with pagination

// Get the first 25 redirects.
var redirects = pizza.Redirects.ListRedirects(1, 25);

Creating and updating redirects.

For creating redirects you have to use a separate model. This is because the redirect.pizza api works with different models too.

var redirect = pizza.Redirects.CreateRedirect(new CreateRedirect()
{
    Sources = new[] { "old.example.com", "testing.example.com" },
    Destination = "https://new.example.com",
    Tracking = true,
    KeepQueryString = false,
    UriForwarding = false,
    Tags = new[] { "NewDomain" }
});

You can update a redirect by making the modifications you want to the model itself. Then you confirm the changes by running redirect.Save():

redirect.Tracking = false;
redirect.Save();

LINQ

RedirectPizza.NET supports interacting with endpoints using a previously returned model. This allows you to create LINQ queries:

pizza.Redirects.ListRedirects().Items
    .Where(r => r.Tags.Contains("Marketing"))
    .ToList()
    .ForEach(r => 
    {
        r.Tags.Add("Sales");
        r.Save();  
    });

So you can delete all marketing redirects:

pizza.Redirects.ListRedirects().Items
    .Where(r => r.Tags.Contains("Marketing"))
    .ToList()
    .ForEach(r => r.Delete());

Or perhaps you gave up on the whole tags thing:

pizza.Redirects.ListRedirects().Items
    .Where(r => r.Tags.Any())
    .ToList()
    .ForEach(r =>
    {
        r.Tags.Clear();
        r.Save();
    });

Exceptions

• PlanLimitReachedException: When you are trying to do an operation that is not available in your plan, for example using the EmailForwards endpoint with a free account.
• UnprocessableEntityException: When you are passing invalid arguments, for example a Tag that is more than 15 characters long.