legalis-api

REST API server for Legalis-RS.

Overview

legalis-api provides a production-ready REST API server built with Axum for managing and evaluating legal statutes programmatically.

Features

• REST API: Full CRUD operations for statutes
• Verification Endpoints: Validate statute consistency
• Evaluation Endpoints: Check eligibility for entities
• Health Checks: Kubernetes-ready health endpoints
• OpenAPI Compatible: Standard REST conventions

Endpoints

Statutes

Verification

Evaluation

Health

Usage

As Library

use legalis_api::{create_router, AppState};
use std::sync::Arc;

#[tokio::main]
async fn main() {
    let state = Arc::new(AppState::new());
    let app = create_router(state);

    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
    axum::serve(listener, app).await.unwrap();
}

Via CLI

# Start API server
legalis serve --host 0.0.0.0 --port 3000

API Examples

# Create a statute
curl -X POST http://localhost:3000/api/v1/statutes \
  -H "Content-Type: application/json" \
  -d '{"id": "adult-rights", "title": "Adult Rights", ...}'

# Verify all statutes
curl -X POST http://localhost:3000/api/v1/verify

# Evaluate an entity
curl -X POST http://localhost:3000/api/v1/evaluate \
  -H "Content-Type: application/json" \
  -d '{"entity": {"age": 25, "income": 50000}}'

Configuration

Cargo Features

The following features are available:

• grpc (enabled by default): gRPC API server with reflection and health checking
• redis-cache: Redis-based caching support for improved performance
• oauth2-auth: OAuth2 authentication and authorization
• otel-tracing: OpenTelemetry tracing integration for observability

Default Build (Includes gRPC)

cargo build

Minimal Build (No gRPC)

If you don't need the gRPC API and want to reduce dependencies:

[dependencies]
legalis-api = { version = "0.1", default-features = false }

Or build with:

cargo build --no-default-features

Custom Feature Combination

[dependencies]
legalis-api = { version = "0.1", default-features = false, features = ["redis-cache", "oauth2-auth"] }

License

MIT OR Apache-2.0