Benevia.Core.API 0.9.17

Benevia.Core.API Summary

Benevia.Core.API provides RESTful OData API infrastructure for Benevia Core entities, automatically generating CRUD endpoints with no boilerplate controllers.

This package includes:

• Automatic CRUD endpoints for each [ApiEntity] entity
• Multi-tenant database access via Entity Framework
• JWT and PAT authentication
• OData query support ($filter, $expand, $select, $search)

Documentation

AI agents should use the documentation on the https://core.benevia.university site. Begin with the following links:

• Documentation specific to this library: API index
• Full documentation of the platform is here: AI Index

Install

dotnet add package Benevia.Core.API

Configuration

{
 "Tenants": {
 "Demo": {
 "ConnectionString": "Host=localhost;Database=demo;Username=postgres;Password=postgres",
 "EncryptionKey": "..."
 }
 },
 "JWT": {
 "Issuer": "yourcompany",
 "Audience": "yourcompany",
 "AccessTokenExpirationHours": 0.5,
 "RefreshTokenExpirationDays": 14
 }
}

Use environment variables in production — the app reads from IConfiguration automatically:

Tenants__Demo__ConnectionString="Host=prod-db;..."

{
 "ApiOptions": {
 "EnableLowerCamelCase": true,
 "MaxTop": 500,
 "MaxNodeCount": 100,
 "MaxExpansionDepth": 5
 }
}

Register in Program.cs

builder.Services
 .AddMyAppModel()
 .AddMyAppEndpoints()
 .AddCoreApi((o, t) => o.UseNpgsql(t?.ConnectionString));

app.UseCoreApi();
app.Run();