Levge.ConsistentResponse 1.1.45

<img src="src/Levge.ConsistentResponse/icon.png" width="100" height="100" alt="Levge.ConsistentResponse logo" />

Levge.ConsistentResponse

Levge.ConsistentResponse, .NET Web API projeleri i�in standartla�t�r�lm�� yan�t yap�lar�, geli�mi� hata y�netimi ve yard�mc� modeller sunan kapsaml� bir k�t�phanedir. API yan�tlar�n�z�n tutarl� olmas�n� sa�lar ve geli�tirme s�recini h�zland�r�r.

�zellikler

• Tutarl� API Yan�tlar�: T�m endpoint'lerinizden ApiResponse<T> format�nda standart ��kt� alman�z� sa�lar.
• Global Hata Y�netimi: �zel exception t�rleri (LevgeException vb.) ve beklenmeyen hatalar i�in merkezi bir middleware i�erir.
• Model Do�rulama (Validation): Ge�ersiz model durumlar�n� (ModelState) otomatik olarak yakalar ve anlaml� hata mesajlar� d�nd�r�r.
• Sayfalama ve Filtreleme: Haz�r PaginationRequest, FilterOption, SortOption modelleri ile listeleme i�lemlerini kolayla�t�r�r.
• URL D�n��t�rme: �ste�e ba�l� olarak URL'leri otomatik olarak kebab-case format�na �evirir (�rn: /api/user-profile).

Kurulum

NuGet paket y�neticisi ile projenize ekleyebilirsiniz:

dotnet add package Levge.ConsistentResponse

Kullan�m

K�t�phaneyi kullanmak i�in Program.cs dosyan�zda servis kayd�n� ve middleware eklemesini yapman�z yeterlidir.

1. Servis Kayd�

AddLevgeConsistentResponse metodu ile gerekli servisleri ve filtreleri ekleyin.

// Program.cs

var builder = WebApplication.CreateBuilder(args);

// ...

// Servisleri ekleyin (lowerUrls: true parametresi URL'lerin k���k harf/kebab-case olmas�n� sa�lar)
builder.Services.AddLevgeConsistentResponse(lowerUrls: true);

var app = builder.Build();

2. Middleware Aktivasyonu

UseLevgeConsistentResponse metodu ile global hata y�netimini devreye al�n. Bu sat�r�n di�er middleware'lerden �nce eklenmesi �nerilir.

// Program.cs

// ...

// Global exception handler'� ekleyin
app.UseLevgeConsistentResponse();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

Yan�t Yap�s� �rnekleri

Ba�ar�l� Yan�t:

{
  "isSuccess": true,
  "message": "��lem ba�ar�l�.",
  "data": {
    "id": 1,
    "name": "�rnek Veri"
  },
  "errors": null
}

Hata Yan�t�:

{
  "isSuccess": false,
  "message": "Bir hata olu�tu.",
  "data": null,
  "errors": {
    "Email": [
      "Email alan� zorunludur."
    ]
  }
}