appcore-api 1.0.0

HTTP API host and transport contracts for AppCore Runtime.
Documentation

appcore-api

English guide | Guia em português | Guide français

Runtime HTTP command/query/status DTOs, router and host.

Stable routes include health, status, command and query V1 endpoints. Business behavior is registered through command/query contracts; product REST resources do not belong in this crate.

HttpApiConfig::max_payload_bytes bounds the complete command/query HTTP body before JSON deserialization. Protected routes reject missing, malformed or duplicate Authorization headers.

The host capability policy authorizes application commands and queries before dispatch. Runtime-owned status queries remain outside application capability declarations.

HttpCommandAuth::default() requires authentication and fails closed until a token verifier is configured. Only insecure_local_for_testing() explicitly disables command/query authentication for controlled local tests. /v1/health remains intentionally public. Rejected command authorization is audited with normalized metadata and never records credentials, payloads or idempotency keys.

cargo test -p appcore-api