Usage API

POST /api/usage/ingest

• Purpose: Ingest usage events from the edge/proxy layer.
• Auth: X-Ingest-Key shared secret.
• Request shape: Usage payload (tenant, bytes, request metadata).
• Response shape: { ok: true }.
• Key errors: 401/403 invalid ingest key, 400 invalid payload.
• Example: POST /api/usage/ingest with ingest key header.

GET /api/usage/check

• Purpose: Internal usage limit/status check.
• Auth: X-Ingest-Key shared secret.
• Request shape: Query for tenant/period (as defined in handler).
• Response shape: Limit/check result.
• Key errors: 401/403, 400.
• Example: GET /api/usage/check?....

GET /api/demos/{provider}

• Purpose: Return demo payload for supported providers.
• Auth: Public read.
• Request shape: Path {provider}.
• Response shape: Demo data for requested provider.
• Key errors: 404 provider not found, 400 invalid provider.
• Example: GET /api/demos/prismic.

GET /api/playground/tenant-config

• Purpose: Return public-safe tenant config used by playground UI bootstrap.
• Auth: Public read.
• Request shape: Query slug (required).
• Response shape: { slug, cms, identifierField, identifierValue, apiOrigin, origin, videoOrigin }; on missing tenant returns same shape with null fields and error.
• Key errors: 400 when slug query param is missing.
• Example: GET /api/playground/tenant-config?slug=demo.