---
title: "Připravit design (vrstvy potisku)"
method: POST
path: "/api/design"
tags: ["design"]
---

# Připravit design (vrstvy potisku)

`POST /api/design`

## Request

- Base URL: `https://konfigurator.suorigo.cz`
- URL: `https://konfigurator.suorigo.cz/api/design`
- Auth: none declared

Zvaliduje vrstvy (strana, umístění v % tiskové plochy 0–100), nahraje obrázky (data URL nebo veřejná URL) a vrátí vrstvy s trvalými URL + orientační příplatek za potisk. Výstupní `layers` vlož do položek objednávky. Vrací i `previewUrl` (best-effort) — sdílený náhled /navrh/<token>, kde zákazník uvidí návrh na tričku v konfigurátoru a může ho tam i sám objednat.

## Request body

- DesignInput
  - `product` string, required
  - `colorId` string
  - `layers` DesignLayer[], required
    - `type` 'image' | 'text', required
    - `side` 'front' | 'back' | 'sideLeft' | 'sideRight', required
    - `x` number, required: % tiskové plochy zleva (0–100)
    - `y` number, required: % tiskové plochy shora (0–100)
    - `width` number, required: % šířky plochy
    - `height` number, required: % výšky plochy
    - `rotation` number
    - `src` string: image: data URL nebo veřejná https URL; po /api/design trvalá URL
    - `text` string
    - `fontFamily` string
    - `fontSize` number
    - `fill` string: barva textu, hex
  - `previewFrontDataUrl` string
  - `previewBackDataUrl` string

## Response `200`

Design uložen

- DesignResult
  - `ok` boolean
  - `status` integer
  - `error` string
  - `designId` string
  - `productId` string
  - `productName` string
  - `colorId` string
  - `layers` DesignLayer[]
    - `type` 'image' | 'text', required
    - `side` 'front' | 'back' | 'sideLeft' | 'sideRight', required
    - `x` number, required: % tiskové plochy zleva (0–100)
    - `y` number, required: % tiskové plochy shora (0–100)
    - `width` number, required: % šířky plochy
    - `height` number, required: % výšky plochy
    - `rotation` number
    - `src` string: image: data URL nebo veřejná https URL; po /api/design trvalá URL
    - `text` string
    - `fontFamily` string
    - `fontSize` number
    - `fill` string: barva textu, hex
  - `previewFront` string, nullable
  - `previewBack` string, nullable
  - `printedSides` integer
  - `printSurchargeNoVatPerPiece` number
  - `previewUrl` string: odkaz /navrh/<token> (best-effort, může chybět) — zákazník tam vidí návrh v konfigurátoru a může ho i sám objednat

## Other responses

- `400`: Neplatný vstup
- `422`: Vrstva mimo tiskovou plochu / nepodporovaný obsah
- `429`: Překročen limit (per IP, per e-mail, globální nebo denní). Text v `error` říká, co se stalo a co dělat; typicky počkej nebo odkaž zákazníka na https://konfigurator.suorigo.cz.

---

[API](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty.md) · [All operations](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/llms.txt) · [OpenAPI document](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/revisions/08c6a3ef2349?raw)