NEXX PLATFORM — API contract artifacts

Versioned snapshots of the APP-facing /api/internal/v1 contract. Updated on every backend deploy. ← Dashboard

Files

File	Description	Action
frontend-handoff.json v1.3.0	Human-readable bundle: changesSince, added/modified endpoints, error codes, models, knownLimitations, demoFixtures, references. Use this as the changelog when reviewing what the backend ships.	Download
openapi-internal-v1.json OpenAPI 3	Machine-readable OpenAPI 3 schema generated by drf-spectacular from live Django routes. Feed this into `openapi-typescript` / `npm run api:generate` for the typed client.	Download

Planned / non-live

File	Description	Action
pagination-search-planned-v1.6.0.md PLANNED · v1.6.0	Zone 13 pagination/search contract shape, frozen 2026-06-11 (TG #248–#252). Not yet implemented. The live contract stays v1.5.2 — do not run `api:generate`/`api:check` against this note. Ships as live v1.6.0 after backend implementation + smoke.	Open
procurement-area-planned-v1.6.0.md PLANNED · v1.6.0	BKG-009 `procurementArea` catalog discovery metadata shape, agreed 2026-06-12 (TG #259–#262): dictionary endpoint, root-category marker with inheritance, derived supplier `procurementAreas`, `area` search filter. Not yet implemented. Ships in the same live v1.6.0 package as pagination/search.	Open

Frontend typed-client refresh

curl -fsSL https://nexx-proxy-progress.srv.acebox.eu/contracts/openapi-internal-v1.json \
  -o openapi-internal-v1.json
npm run api:generate

Live API

Health: /api/health/
Swagger UI: /api/docs/
Live schema (always-current): /api/schema/ (note: not always identical to the pinned bundle above; the bundle is the published contract, the live schema is the runtime)

Other artifacts

QA_PERSONAS.md — demo user persona conventions (matches seed_frontend_demo)

nginx serves /contracts/*.json with Content-Disposition: attachment so clicking the link forces "Save As" instead of inline display. Typed-client generators (curl, fetch, openapi-typescript) read the file directly — no auth, no headers required.