Game Tournament API

Detta är min implementation av Game Tournament API-projektet för ASP.NET Core-modulen. Detta API gör det möjligt för arrangörer att skapa och hantera spelturneringar samt schemalägga specifika matcher inom dessa turneringar.

Projektöversikt

Jag byggde detta RESTful Web API med ASP.NET Core och Entity Framework Core med en SQLite-databas. Jag har följt en "Clean-ish"-arkitektur och separerat ansvarsområden i Controllers-, Services- och Data-lager.

Implementerade huvudfunktioner

• CRUD-operationer: Fullständiga Create-, Read-, Update- och Delete-funktioner för både Tournaments och Games.
• Datamodeller och relationer:
  • Tournament: Har en titel, beskrivning, max antal spelare och datum.
  • Game: Har en titel, tid och tillhör en Tournament (en-till-många-relation).
• DTO-mönster: Använde Data Transfer Objects (Create, Update, Response) för att frikoppla de interna databasmodellerna från API-kontrakten.
• Validering: Lade till strikta valideringsregler med hjälp av Data Annotations (t.ex. minsta stränglängd) och ett anpassat FutureDateAttribute för att säkerställa att datum inte sätts i dåtid.
• Integration av service-lager: All affärslogik och databasåtkomst är inkapslad i ITournamentService och IGameService.
• Sökfunktion: GET /api/tournaments-endpointen accepterar en valfri ?search= query-parameter för att filtrera turneringar via titel.
• JWT-säkerhet: Implementerade JWT-autentisering för skydd av känsliga endpoints.

Frivilliga extra krav

Med mått av 1–5 ⭐ i komplexitet (hur svåra de är):

1. Säkra DELETE-endpoints med JWT-token (4/5 ⭐)

DELETE-endpoints är skyddade med JWT-autentisering och kräver en giltig Bearer-token för åtkomst.

2. Seed data (startdata) med Entity Framework Core (2/5 ⭐)

Lade till funktionalitet för seed data där startdata automatiskt läggs till i databasen med hjälp av EF Core när Web API:t startar.

3. Rate Limiting på POST-endpoints (2/5 ⭐)

Implementerade Rate Limiting för att skydda API:t mot spam genom att använda:

using System.Threading.RateLimiting;

Detta begränsar klienter till ett visst antal förfrågningar under en given tidsperiod.

4. Partiella uppdateringar med PATCH (3/5 ⭐)

Lade till en PATCH-endpoint för uppdatering av delar av en entity (till skillnad från PUT som uppdaterar hela entities). Detta blir något mer komplext om man implementerar en separat DTO för partiella uppdateringar.

Hur du kör projektet

1. Klona repot

git clone https://github.com/Mahamed-2/Game-Tournament-API-Project.git
cd Game-Tournament-API-Project/TournamentApi

2. Återställ beroenden och bygg

dotnet restore
dotnet build

3. Kör applikationen

dotnet run

4. Utforska API:t

När applikationen körs kan du navigera till:

http://localhost:<port>/swagger

i din webbläsare för att interagera med API-endpoints via Swagger UI.

Testa autentisering

För att testa de skyddade DELETE-endpointsen kan du hämta en JWT-token från POST /api/auth/login-endpointen med följande hårdkodade testuppgifter:

• Användarnamn: M2
• Lösenord: bestteachers

Klistra in den returnerade token i knappen Authorize högst upp i Swagger UI med formatet:

Bearer <your_token>