refit

USE FOR: Defining type-safe HTTP API clients using interfaces and attributes with Refit's source generator. Use when consuming REST APIs where compile-time safety, automatic serialization, and integration with HttpClientFactory and DI are needed. DO NOT USE FOR: Low-level HTTP operations requiring manual stream control (use HttpClient directly), GraphQL clients (use StrawberryShake or GraphQL.Client), or file download/upload with custom progress reporting (use HttpClient with stream copying).

الانتقال إلى التثبيت

المستودع: Tyler-R-Kendrick/agent-skills
آخر نشاط في المصدر: ١١ فبراير ٢٠٢٦ في ٠٥:١٤
لغة SKILL.md المكتشفة: الإنجليزية
النجوم: ١٠
التفرعات: ٤

خيارات التثبيت

يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.

npx skills add https://github.com/Tyler-R-Kendrick/agent-skills --skill refit

يبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.

تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.

مراجعة ملفات المصدر

اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.

مستكشف الملفات

21 ملفات

SKILL.md

تعليمات المصدر · معاينة للقراءة فقط

العودة إلى البحث العودة إلى التثبيت

name	refit
description	USE FOR: Defining type-safe HTTP API clients using interfaces and attributes with Refit's source generator. Use when consuming REST APIs where compile-time safety, automatic serialization, and integration with HttpClientFactory and DI are needed. DO NOT USE FOR: Low-level HTTP operations requiring manual stream control (use HttpClient directly), GraphQL clients (use StrawberryShake or GraphQL.Client), or file download/upload with custom progress reporting (use HttpClient with stream copying).
license	MIT
metadata	{"displayName":"Refit","author":"Tyler-R-Kendrick","version":"1.0.0"}
compatibility	["claude","copilot","cursor"]
references	[{"title":"Refit GitHub Repository","url":"https://github.com/reactiveui/refit"},{"title":"Refit NuGet Package","url":"https://www.nuget.org/packages/Refit"}]

Refit

Overview

Refit is a type-safe REST client library for .NET that turns interface definitions into live HTTP clients using source generators. You define an interface with attributes like [Get], , , and on methods, and Refit generates the implementation at compile time. Refit handles URL interpolation, query string building, JSON serialization/deserialization, multipart uploads, and header management. It integrates with for proper handler lifecycle management and with ASP.NET Core's dependency injection for clean service registration. Refit uses by default and supports as an alternative serializer.

using Refit; namespace MyApp.ApiClients; // Option 1: Use ApiResponse<T> for non-throwing error handling public interface IOrdersApi { [Get("/api/orders/{id}")] Task<ApiResponse<OrderDto>> GetByIdAsync(int id); [Post("/api/orders")] Task<ApiResponse<OrderDto>> CreateAsync([Body] CreateOrderRequest request); } // Service using ApiResponse<T> public class OrderService { private readonly IOrdersApi _api; private readonly ILogger<OrderService> _logger; public OrderService(IOrdersApi api, ILogger<OrderService> logger) { _api = api; _logger = logger; } public async Task<OrderResult> GetOrderAsync(int id) { using var response = await _api.GetByIdAsync(id); if (response.IsSuccessStatusCode && response.Content is not null) { return OrderResult.Success(response.Content); } _logger.LogWarning( "Failed to get order {Id}. Status: {Status}, Error: {Error}", id, response.StatusCode, response.Error?.Content); return response.StatusCode switch { System.Net.HttpStatusCode.NotFound => OrderResult.NotFound(), System.Net.HttpStatusCode.Unauthorized => OrderResult.Unauthorized(), _ => OrderResult.Error($"API returned {response.StatusCode}") }; } } // Option 2: Use try-catch with ApiException public class ProductService { private readonly IProductsApi _api; public ProductService(IProductsApi api) => _api = api; public async Task<ProductDto?> GetProductAsync(int id) { try { return await _api.GetByIdAsync(id); } catch (ApiException ex) when (ex.StatusCode == System.Net.HttpStatusCode.NotFound) { return null; } catch (ApiException ex) { var errorBody = await ex.GetContentAsAsync<ProblemDetails>(); throw new ExternalApiException( $"Products API error: {errorBody?.Detail ?? ex.Message}", ex); } } }

Feature	Refit	RestSharp	HttpClient	Flurl
Approach	Interface + attributes	Builder pattern	Manual requests	Fluent URL builder
Code generation	Source generator	None	None	None
Type safety	Compile-time	Runtime	Runtime	Runtime
Serialization	Auto (STJ / Newtonsoft)	Auto (STJ / Newtonsoft)	Manual	Auto (STJ / Newtonsoft)
HttpClientFactory	Built-in integration	v107+ support	Native	Built-in integration
Error handling	ApiException / ApiResponse	RestResponse	HttpResponseMessage	FlurlHttpException
Multipart upload	`[Multipart]` + `StreamPart`	`AddFile()`	`MultipartFormDataContent`	`PostMultipartAsync()`
Query objects	`[Query]` on complex types	`AddQueryParameter()`	Manual string building	`SetQueryParams()`

refit

خيارات التثبيت

مراجعة ملفات المصدر

Refit

Overview

Refit

Overview

Defining API Interfaces

ASP.NET Core Registration with HttpClientFactory

Authentication with Delegating Handlers

Error Handling with ApiException

Headers and Dynamic Configuration

Refit vs Other HTTP Client Libraries

Best Practices

refit

معلومات المصدر

خيارات التثبيت

مراجعة ملفات المصدر

المزيد من هذا المستودع

المزيد من هذا المستودع

Refit

Overview

Refit

Overview

Defining API Interfaces

ASP.NET Core Registration with HttpClientFactory

Authentication with Delegating Handlers

Error Handling with ApiException

Headers and Dynamic Configuration

Refit vs Other HTTP Client Libraries

Best Practices