Files
chart/bible-local/architecture/api-surface.md
2026-03-15 17:28:19 +03:00

36 lines
947 B
Markdown

# API Surface
## Primary Integration Style
The package is intended to be embedded by other Go applications.
Expected package shape:
- `viewer.RenderHTML(snapshot []byte) ([]byte, error)`
- `viewer.NewHandler(...) http.Handler`
Exact signatures may change during implementation, but the integration model is fixed:
- embedding app provides the JSON
- chart renders HTML
## Expected Runtime Endpoints
These endpoints are expected for the standalone binary only:
- `GET /` - viewer page
- `POST /render` - accept one Reanimator JSON payload and return rendered HTML or JSON render result
- `GET /healthz` - basic process health
## UI Route Rules
- No multi-product navigation
- No upload wizard with preview/confirm/execute stages
- No collector/API-connect workflow
- No background job polling API
## Response Rules
- HTML pages are read-only views of one snapshot
- API responses must not modify or augment the input payload semantics