34 lines
862 B
Markdown
34 lines
862 B
Markdown
# `GET /v1/cimage`
|
|
|
|
Protected. Requires a valid session cookie (`credentials: 'include'`).
|
|
|
|
POS category image delivery
|
|
|
|
Returns category image by hash (`path` query param) scaled to preview size with 3:4 portrait ratio.
|
|
|
|
|
|
## Query parameters
|
|
|
|
| Param | Required | Type | Description |
|
|
|-------|----------|------|-------------|
|
|
| `path` | yes | string | SHA-256 hash of the category image |
|
|
| `w` | no | integer | Max width |
|
|
| `h` | no | integer | Max height |
|
|
| `format` | no | string | Optional target format (defaults to jpeg/png or client Accept preference) |
|
|
|
|
## Response `200`
|
|
|
|
Resized image binary
|
|
|
|
## Errors
|
|
|
|
| Status | Description |
|
|
|--------|-------------|
|
|
| 304 | Image not modified |
|
|
| 400 | Missing required query parameter 'path' |
|
|
| 404 | Image not found |
|
|
|
|
---
|
|
|
|
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._
|