huntapi/README.md

HuntingAppApi

ASP.NET Core / .NET 10 Web API sample using Controllers, Newtonsoft.Json, Npgsql and PostGIS.

Setup

createdb hunting_app
psql -d hunting_app -f Sql/001_schema.sql
dotnet restore
dotnet run

Update appsettings.json with your PostgreSQL connection string and JWT secret.

Main endpoints

• POST /api/auth/external-login
• GET /api/hunt-areas
• POST /api/hunt-areas
• GET /api/map-points/area/{huntAreaId}
• POST /api/map-points
• GET /api/hunts/area/{huntAreaId}
• POST /api/hunts
• POST /api/hunts/{huntId}/participants
• POST /api/hunts/{huntId}/assignments
• GET /api/hunts/{huntId}/participant-locations
• POST /api/locations
• GET /api/hunts/{huntId}/messages
• POST /api/hunts/{huntId}/messages

Important production notes

The external token validator is intentionally simple. Before production, validate Google/Microsoft ID tokens against issuer, audience/client ID, expiry and JWKS signature validation.