> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Šablony

> Ukládejte znovu použitelné designy QR kódů a používejte je pro nové QR kódy.

> [!NOTE]
>
> GetQR API je v beta verzi a je dostupné pro vybrané pracovní prostory. Do obecného vydání se podrobnosti mohou změnit.

Šablona ukládá znovu použitelný design: `styles`, `frameOptions` a `logoOptions`. Nikdy neobsahuje obsah ani odkaz. Šablony sdílí všichni v pracovním prostoru.

| Metoda | Cesta | Popis |
| - | - | - |
| `GET` | `/api/v1/templates` | [Výpis šablon](#výpis-šablon) |
| `POST` | `/api/v1/templates` | [Vytvoření šablony](#vytvoření-šablony) |
| `GET` | `/api/v1/templates/{templateId}` | [Získání šablony](#získání-šablony) |
| `PATCH` | `/api/v1/templates/{templateId}` | [Úprava šablony](#úprava-šablony) |
| `DELETE` | `/api/v1/templates/{templateId}` | [Smazání šablony](#smazání-šablony) |
| `POST` | `/api/v1/templates/{templateId}/duplicate` | [Duplikace šablony](#duplikace-šablony) |

## Použití šablony

Předejte `templateId`, když [vytváříte QR kód](https://docs.getqr.com/cs/api/endpoints/qr-codes.md). Design šablony se použije pro nový QR kód. Kterýkoli ze tří objektů designu, který pošlete ve stejném požadavku, se s ním sloučí a má přednost.

* **Kopie, ne propojení.** QR kód si ponechá vlastní kopii designu. Pozdější úprava nebo smazání šablony ho nezmění.
* **Jen vlastní designy.** Šablonu s `designKind` `branded` nebo `ai` nelze přes API použít a vrátí `422` (`art_template_unsupported`).
* **Jen váš pracovní prostor.** Neznámá šablona nebo šablona z jiného pracovního prostoru vrátí `404`.

## Hlavičky

**Authorization** `string` *required*

`Bearer` následovaný vaším API klíčem. Viz [Ověřování](https://docs.getqr.com/cs/api/authentication.md).

**Content-Type** `string`

`application/json`. Povinné u požadavků s tělem.

## Objekt šablony

**id** `string`

ID šablony, například `qrt_8Hs2mQvKpLd4RtYw`.

**name** `string`

Název zobrazený při výběru šablony.

**designKind** `string`

Jen pro čtení. `custom` je design, který API může plně upravovat. `branded` a `ai` jsou design Branded nebo AI vytvořený v dashboardu: jeho obrázek přes API upravit nelze a při změně ostatních polí designu se zachová.

**design** `object`

Uložený design. Každé pole má stejný tvar jako stejnojmenné pole požadavku, takže ho můžete poslat zpět.

**properties**

**styles** `object | null`

Tvary a barvy bodů a rohů.

**frameOptions** `object | null`

Rámeček kolem QR kódu a text jeho výzvy k akci.

**logoOptions** `object | null`

Logo uprostřed.

**createdAt** `string`

Datum vytvoření, ISO 8601.

**updatedAt** `string`

Datum poslední úpravy, ISO 8601.

## Výpis šablon

`GET /api/v1/templates`

Vrací šablony vašeho pracovního prostoru od nejnovějších. Seznam je stránkovaný: viz [Stránkování](https://docs.getqr.com/cs/api/introduction.md#stránkování).

**page** `integer` (default: 1)

Stránka, která se má vrátit, 1 nebo vyšší.

**pageSize** `integer` (default: 100)

Počet výsledků na stránku, 1 až 100.

```bash cURL theme={null}
curl "https://getqr.com/api/v1/templates?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "qrt_8Hs2mQvKpLd4RtYw",
      "name": "Brand blue",
      "designKind": "custom",
      "design": {
        "styles": {
          "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
          "backgroundOptions": { "color": "#FFFFFF" }
        },
        "frameOptions": null,
        "logoOptions": null
      },
      "createdAt": "2026-07-20T09:12:00.000Z",
      "updatedAt": "2026-07-20T09:12:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}
```

## Vytvoření šablony

`POST /api/v1/templates`

Uloží nový design. Odpoví `201 Created`. Pole designu se ověřují podle katalogů v části [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md), takže neznámý tvar, rámeček nebo logo se odmítne s `422`.

**name** `string` *required*

Název zobrazený při výběru šablony, 1 až 40 znaků.

**styles** `object`

Tvary a barvy bodů a rohů. Viz [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md).

**frameOptions** `object`

Rámeček kolem QR kódu a text jeho výzvy k akci. Viz [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md).

**logoOptions** `object`

Logo uprostřed: navrhované logo nebo vlastní soubor nahraný s cílem `logo` přes [Soubory](https://docs.getqr.com/cs/api/endpoints/files.md). Viz [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md).

```bash cURL theme={null}
curl -X POST "https://getqr.com/api/v1/templates" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brand blue",
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    }
  }'
```

```json 201 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-07-20T09:12:00.000Z"
}
```

## Získání šablony

`GET /api/v1/templates/{templateId}`

**templateId** `string` *required*

ID šablony. Najdete ho v odpovědi výpisu nebo vytvoření.

```bash cURL theme={null}
curl "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-07-20T09:12:00.000Z"
}
```

## Úprava šablony

`PATCH /api/v1/templates/{templateId}`

Pošlete jen pole, která chcete změnit. Objekty designu se sloučí s uloženým designem, takže částečné `styles` zachová zbytek. QR kódy už vytvořené ze šablony si ponechají design, se kterým vznikly.

**templateId** `string` *required*

ID šablony.

**name** `string`

Nový název, 1 až 40 znaků.

**styles** `object`

Změny stylů, sloučené s uloženými `styles`.

**frameOptions** `object`

Změny rámečku, sloučené s uloženým rámečkem.

**logoOptions** `object`

Změny loga, sloučené s uloženým logem.

```bash cURL theme={null}
curl -X PATCH "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Brand blue (2026)" }'
```

```json 200 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue (2026)",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-08-14T09:00:00.000Z"
}
```

## Smazání šablony

`DELETE /api/v1/templates/{templateId}`

Smaže šablonu. QR kódy, které z ní vznikly, si design ponechají.

**templateId** `string` *required*

ID šablony.

```bash cURL theme={null}
curl -X DELETE "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{ "id": "qrt_8Hs2mQvKpLd4RtYw", "deleted": true }
```

## Duplikace šablony

`POST /api/v1/templates/{templateId}/duplicate`

Vytvoří kopii s názvem `<name> copy`, s vlastním ID a nezávislým designem, který můžete volně upravovat. Nepřijímá tělo požadavku. Odpoví `201 Created`.

**templateId** `string` *required*

ID šablony, která se má zkopírovat.

```bash cURL theme={null}
curl -X POST "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw/duplicate" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 201 theme={null}
{
  "id": "qrt_2Kd9pLm4Xs7BnVcQ",
  "name": "Brand blue copy",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-08-14T09:30:00.000Z",
  "updatedAt": "2026-08-14T09:30:00.000Z"
}
```

## Časté problémy

> [accordion] 404 "QR template not found."
>
> `templateId` neodpovídá žádné šabloně ve vašem pracovním prostoru. Převezměte ho z [výpisu šablon](#výpis-šablon).

> [accordion] 422 při vytváření nebo úpravě šablony
>
> Některé pole designu neodpovídá katalogům, například neznámý typ bodů, rámeček nebo navrhované logo. Zpráva uvádí název pole. Viz [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md).

> [accordion] 422 art\_template\_unsupported při vytváření QR kódu
>
> Šablona používá design Branded nebo AI. Použijte místo ní šablonu s `designKind` `custom`.

## Co dál

> [card] [Přizpůsobení](https://docs.getqr.com/cs/api/guides/customization.md)

> [card] [QR kódy](https://docs.getqr.com/cs/api/endpoints/qr-codes.md)

> [card] [Šablony v aplikaci](https://docs.getqr.com/cs/templates/save-template.md)

> [card] [Soubory](https://docs.getqr.com/cs/api/endpoints/files.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.