dashback/docs/api/README.md

Dash API

http://localhost:4208/api

CORS & cookies

All browser requests that need auth must send cookies:

fetch('http://localhost:4208/api/auth/me', {
  credentials: 'include',
});

Sessions use an HTTP-only token cookie (Secure, SameSite=Strict, 24h). The browser must talk to the API over HTTPS for login to work — Secure cookies are not sent on plain HTTP.

Auth flow

1. Call GET /auth/me to get googleClientId (included in 200 and 401 responses).
2. Sign in with Google on the frontend (Google Identity Services / One Tap).
3. POST the Google ID token to POST /auth/login.
4. The API sets the session cookie.
5. Call protected routes with credentials: 'include'. The cookie is refreshed automatically when it has less than 2 hours left.

Routes

Generated from @openapi annotations in src/api/routes/. Source of truth is the code; regenerate with npm run docs:api.

File	Endpoint
routes/article/create.md	POST /article
routes/article/delete.md	DELETE /article/{sku}
routes/article/get.md	GET /article/{sku}
routes/article/update.md	PATCH /article/{sku}
routes/article/set-brand.md	PUT /article/{sku}/brand
routes/article/set-categories.md	PUT /article/{sku}/categories
routes/article/set-eans.md	PUT /article/{sku}/eans
routes/article/add-image.md	POST /article/{sku}/image
routes/article/delete-image.md	DELETE /article/{sku}/image/{fullHash}
routes/article/order-images.md	PUT /article/{sku}/images/order
routes/article/set-prices.md	PUT /article/{sku}/prices
routes/article/set-weight.md	PUT /article/{sku}/weight
routes/auth/login.md	POST /auth/login
routes/auth/logout.md	POST /auth/logout
routes/auth/me.md	GET /auth/me
routes/auth/selected-company.md	PUT /auth/selected-company
routes/brand/list.md	GET /brand
routes/brand/upsert.md	PUT /brand
routes/brand/delete.md	DELETE /brand/{id}
routes/category/create.md	POST /category
routes/category/tree.md	GET /category/tree
routes/category/delete.md	DELETE /category/{id}
routes/category/rename.md	PATCH /category/{id}
routes/category/articles.md	GET /category/{id}/articles
routes/company/list.md	GET /company
routes/company/create.md	POST /company
routes/company/delete.md	DELETE /company/{id}
routes/company/update.md	PUT /company/{id}
routes/health.md	GET /health
routes/image/get.md	GET /image/{fullHash}
routes/thumb/get.md	GET /thumb/{fullHash}
routes/unit/delete.md	DELETE /unit
routes/unit/list.md	GET /unit
routes/unit/upsert.md	PUT /unit

Machine-readable spec: openapi.json.

DESIGN

• for every route we have a file in /src/api/routes
• that should loosly bound to services in /src/services
• for every service we have a CLI tester in /scripts/
• all DB SQL code shall be in /src/db
• with mssql staements in /src/db/mssql/
• API docs: @openapi JSDoc on handlers → npm run docs:api → docs/api/