Refitter 0.2.2-alpha

This is a prerelease version of Refitter.
There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global Refitter --version 0.2.2-alpha
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local Refitter --version 0.2.2-alpha
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Refitter&version=0.2.2-alpha&prerelease
                    
nuke :add-package Refitter --version 0.2.2-alpha
                    

Build Smoke Tests NuGet

Refitter

Refitter is a CLI tool for generating a C# REST API Client using the Refit library.

Installation:

The tool is packaged as a .NET Tool and is published to nuget.org. You can install the latest version of this tool like this:

dotnet tool install --global Refitter --prerelease

Usage:

To generate code from an OpenAPI specifications file, run the following:

$ refitter [path to OpenAPI spec file] --namespace "[Your.Namespace.Of.Choice.GeneratedCode]"

This will generate a file called Output.cs which contains the Refit interface and contract classes generated using NSwag

Here's an example generated output from the Swagger Petstore example

using Refit;
using System.Threading.Tasks;
using System.Collections.Generic;

namespace GeneratedCode
{
    public interface ISwaggerPetstore
    {
        /// <summary>
        /// Update an existing pet by Id
        /// </summary>
        [Put("/pet")]
        Task<Pet> UpdatePet([Body]Pet body);

        /// <summary>
        /// Add a new pet to the store
        /// </summary>
        [Post("/pet")]
        Task<Pet> AddPet([Body]Pet body);

        /// <summary>
        /// Multiple status values can be provided with comma separated strings
        /// </summary>
        [Get("/pet/findByStatus")]
        Task<ICollection<Pet>> FindPetsByStatus();

        /// <summary>
        /// Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
        /// </summary>
        [Get("/pet/findByTags")]
        Task<ICollection<Pet>> FindPetsByTags();

        /// <summary>
        /// Returns a single pet
        /// </summary>
        [Get("/pet/{petId}")]
        Task<Pet> GetPetById(long? petId);

        [Post("/pet/{petId}")]
        Task UpdatePetWithForm(long? petId);

        [Delete("/pet/{petId}")]
        Task DeletePet(long? petId);

        [Post("/pet/{petId}/uploadImage")]
        Task<ApiResponse> UploadFile(long? petId, [Body]StreamPart body);

        /// <summary>
        /// Returns a map of status codes to quantities
        /// </summary>
        [Get("/store/inventory")]
        Task<IDictionary<string, int>> GetInventory();

        /// <summary>
        /// Place a new order in the store
        /// </summary>
        [Post("/store/order")]
        Task<Order> PlaceOrder([Body]Order body);

        /// <summary>
        /// For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
        /// </summary>
        [Get("/store/order/{orderId}")]
        Task<Order> GetOrderById(long? orderId);

        /// <summary>
        /// For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
        /// </summary>
        [Delete("/store/order/{orderId}")]
        Task DeleteOrder(long? orderId);

        /// <summary>
        /// This can only be done by the logged in user.
        /// </summary>
        [Post("/user")]
        Task CreateUser([Body]User body);

        /// <summary>
        /// Creates list of users with given input array
        /// </summary>
        [Post("/user/createWithList")]
        Task<User> CreateUsersWithListInput([Body]ICollection<User> body);

        [Get("/user/login")]
        Task<string> LoginUser();

        [Get("/user/logout")]
        Task LogoutUser();

        [Get("/user/{username}")]
        Task<User> GetUserByName(string username);

        /// <summary>
        /// This can only be done by the logged in user.
        /// </summary>
        [Put("/user/{username}")]
        Task UpdateUser(string username, [Body]User body);

        /// <summary>
        /// This can only be done by the logged in user.
        /// </summary>
        [Delete("/user/{username}")]
        Task DeleteUser(string username);
    }
}

Using the generated code

RestService

Here's an example usage of the generated code above

using Refit;
using System;
using System.Threading.Tasks;

namespace GeneratedCode;

internal class Program
{
    private static async Task Main(string[] args)
    {
        var client = RestService.For<ISwaggerPetstore>("https://petstore3.swagger.io/api/v3");
        var pet = await client.GetPetById(2);

        Console.WriteLine($"Name: {pet.Name}");
        Console.WriteLine($"Category: {pet.Category.Name}");
        Console.WriteLine($"Status: {pet.Status}");
    }
}

The RestService class generates an implementation of ISwaggerPetstore that uses HttpClient to make its calls.

The code above when run will output something like this:

Name: Gatitotototo
Category: Chaucito
Status: Sold

ASP.NET Core and HttpClientFactory

Here's an example Minimal API with the Refit.HttpClientFactory library:

using Refit;
using GeneratedCode;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services
    .AddRefitClient<ISwaggerPetstore>()
    .ConfigureHttpClient(c => c.BaseAddress = new Uri("https://petstore3.swagger.io/api/v3"));

var app = builder.Build();
app.MapGet(
        "/pet/{id:long}",
        async (ISwaggerPetstore petstore, long id) =>
        {
            try
            {
                return Results.Ok(await petstore.GetPetById(id));
            }
            catch (Refit.ApiException e)
            {
                return Results.StatusCode((int)e.StatusCode);
            }
        })
    .WithName("GetPetById")
    .WithOpenApi();

app.UseHttpsRedirection();
app.UseSwaggerUI();
app.UseSwagger();
app.Run();

.NET Core supports registering the generated ISwaggerPetstore interface via HttpClientFactory

The following request to the API above

$ curl -X 'GET' 'https://localhost:5001/pet/1' -H 'accept: application/json'

Returns a response that looks something like this:

{
  "id": 1,
  "name": "Special_char_owner_!@#$^&()`.testing",
  "photoUrls": [
    "https://petstore3.swagger.io/resources/photos/623389095.jpg"
  ],
  "tags": [],
  "status": "Sold"
}

System requirements

.NET 7.0

For tips and tricks on software development, check out my blog

If you find this useful and feel a bit generous then feel free to buy me a coffee ☕

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.6.4-preview.80 111 9/20/2025
1.6.3 53,286 9/18/2025
1.6.3-preview.79 238 9/17/2025
1.6.3-preview.78 129 9/13/2025
1.6.3-preview.77 130 9/11/2025
1.6.2 335,422 8/18/2025
1.6.2-preview.76 158 8/13/2025
1.6.1 274,165 7/8/2025
1.6.1-preview.75 135 7/8/2025
1.6.0 104,986 6/17/2025
1.6.0-preview.74 358 6/10/2025
1.5.6 94,121 6/7/2025
1.5.6-preview.73 141 5/31/2025
1.5.5 344,140 5/4/2025
1.5.5-preview.70 66 5/30/2025
1.5.5-preview.69 163 4/30/2025
1.5.4 88,998 4/26/2025
1.5.3 344,791 3/30/2025
1.5.3-preview.68 309 3/23/2025
1.5.3-preview.67 613 1/30/2025
1.5.2 933,142 1/29/2025
1.5.1 61,244 1/25/2025
1.5.1-preview.66 90 1/25/2025
1.5.0 87,711 1/19/2025
1.5.0-preview.65 436 12/8/2024
1.5.0-preview.64 102 12/7/2024
1.5.0-preview.63 105 12/7/2024
1.4.1 931,136 11/20/2024
1.4.1-preview.62 195 11/4/2024
1.4.0 358,307 10/14/2024
1.4.0-preview.61 134 10/7/2024
1.3.2 328,468 9/23/2024
1.3.2-preview.60 92 9/23/2024
1.3.1 49,036 9/20/2024
1.3.0 96,885 9/14/2024
1.2.1-preview.59 91 9/13/2024
1.2.1-preview.58 107 9/11/2024
1.2.1-preview.57 94 9/11/2024
1.2.1-preview.56 109 9/9/2024
1.2.1-preview.55 3,269 9/2/2024
1.2.1-preview.54 4,750 8/29/2024
1.2.0 561,677 8/12/2024
1.2.0-preview.53 5,210 8/4/2024
1.2.0-preview.52 1,876 7/29/2024
1.1.3 359,906 7/19/2024
1.1.3-preview.51 95 7/19/2024
1.1.2 25,518 7/17/2024
1.1.2-preview.50 81 7/16/2024
1.1.2-preview.49 99 7/11/2024
1.1.1 188,820 7/6/2024
1.1.1-preview.48 105 7/4/2024
1.1.1-preview.47 100 7/1/2024
1.1.1-preview.46 104 6/28/2024
1.1.0.45-preview 129 6/25/2024
1.0.2 238,623 6/13/2024
1.0.1 48,401 6/7/2024
1.0.0 246,187 5/3/2024
0.9.9.44-preview 116 4/29/2024
0.9.9 8,164 3/7/2024
0.9.8 3,740 2/27/2024
0.9.7 72,041 2/7/2024
0.9.6 294 1/29/2024
0.9.5 41,791 1/15/2024
0.9.4.43-preview 140 1/15/2024
0.9.4 32,138 1/12/2024
0.9.3.42-preview 180 1/10/2024
0.9.2 20,159 1/10/2024
0.9.1 3,947 1/9/2024
0.9.0 3,145 1/9/2024
0.8.7.41-preview 182 1/3/2024
0.8.7.40-preview 164 12/20/2023
0.8.7 55,085 12/18/2023
0.8.6.39-preview 178 12/14/2023
0.8.6.38-preview 210 12/14/2023
0.8.6 3,596 12/11/2023
0.8.5 57,051 11/23/2023
0.8.4 435 11/7/2023
0.8.3 303 10/31/2023
0.8.2 473 10/9/2023
0.8.1 932 10/4/2023
0.8.0 1,800 9/23/2023
0.7.5 2,789 9/7/2023
0.7.4 407 9/6/2023
0.7.3.37-preview 266 8/25/2023
0.7.3.36-preview 306 8/25/2023
0.7.3.35-preview 304 8/21/2023
0.7.3.34-preview 305 8/15/2023
0.7.3.33-preview 284 8/12/2023
0.7.3 2,085 8/26/2023
0.7.2.32-preview 280 8/7/2023
0.7.2 3,920 8/7/2023
0.7.1.31-preview 312 8/2/2023
0.7.1.30-preview 246 8/2/2023
0.7.1.29-preview 311 8/1/2023
0.7.1 759 8/3/2023
0.7.0.28-preview 236 7/28/2023
0.7.0.27-preview 338 7/28/2023
0.7.0.26-preview 321 7/27/2023
0.7.0.23-preview 309 7/27/2023
0.7.0.22-preview 360 7/27/2023
0.7.0.21-preview 297 7/27/2023
0.7.0.20-preview 336 7/27/2023
0.7.0 493 7/31/2023
0.6.3 1,258 7/22/2023
0.6.2 14,533 6/22/2023
0.6.1 390 6/20/2023
0.6.0 783 6/15/2023
0.5.30 580 6/12/2023
0.5.29 213 6/12/2023
0.5.28 238 6/10/2023
0.5.27 293 5/24/2023
0.5.26 354 5/11/2023
0.5.25 280 5/10/2023
0.5.3 262 5/5/2023
0.5.2 233 5/2/2023
0.5.1 237 5/2/2023
0.5.0 287 4/28/2023
0.4.2 316 4/24/2023
0.4.1 514 4/3/2023
0.4.0 376 3/24/2023
0.3.17 13,132 3/24/2023
0.3.16 318 3/22/2023
0.3.4 292 3/22/2023
0.3.3 375 3/17/2023
0.3.2 354 3/16/2023
0.3.1 322 3/14/2023
0.3.0 327 3/14/2023
0.2.4-alpha 334 3/1/2023
0.2.3-alpha 249 2/27/2023
0.2.2-alpha 293 2/25/2023
0.2.1-alpha 319 2/25/2023
0.2.0-alpha 271 2/24/2023
0.1.5-alpha 321 2/18/2023
0.1.4-alpha 356 2/17/2023
0.1.3-alpha 347 2/17/2023
0.1.2-alpha 315 2/17/2023