furniture-bff/docs/api/external-api-surface.md
2026-03-11 10:30:48 -06:00

19 lines
637 B
Markdown

# External API Surface
## Active External Protocol
- REST is the active external protocol for this BFF deployment.
## Endpoint Baseline
- `GET /api/furniture/{furnitureId}/availability`
- Auth required: valid Thalos session (`thalos_session` or `thalos_refresh` cookie, validated via `/api/identity/session/me`)
- Anonymous exceptions: `/health`, `/healthz`
## Edge Responsibilities
- Validate and normalize consumer request inputs.
- Map edge requests to furniture-service transport-neutral contracts.
- Map downstream furniture-service responses to consumer-facing shapes.
- Map downstream errors to consistent API error models.