1. Install Refit

   1
   dotnet add package Refit
   2
   dotnet add package Refit.HttpClientFactory
   

2. Create interface

   1
   public interface IGithubApi
   2
   {
   3
       [Get("/users/{userName}")]
   4
       Task<User?> GetUserAsync(string username, CancellationToken cancellationToken = default);
   5
   }
   9 collapsed lines
   6
   public class User
   7
   {
   8
       [JsonPropertyName("id")]
   9
       public long Id { get; set; }
   10
       [JsonPropertyName("login")]
   11
       public string Login { get; set; } = string.Empty;
   12
       [JsonPropertyName("avatar_url")]
   13
       public string AvatarUrl { get; set; } = string.Empty;
   14
   }
   

3. Configure refit client

   1
   builder.Services
   2
       .AddRefitClient<IGithubApi>()
   3
       .ConfigureHttpClient(c =>
   4
       {
   5
           c.BaseAddress = new Uri("https://api.github.com");
   6
           c.DefaultRequestHeaders.UserAgent.TryParseAdd("request");
   7
       });
   

4. Map endpoint

   1
   app.MapGet("github/{userName}", async (
   2
       IGithubApi githubApi,
   3
       [FromRoute] string userName,
   4
       CancellationToken cancellationToken) =>
   5
   {
   6
       var response = await githubApi.GetUserAsync(userName, cancellationToken);
   7
       return Results.Ok(response);
   8
   });
   

References#

• Refit nuget package